連接不上時怎麼排查

請先對照以下四種情況，它們的成因各不相同。

一直顯示「正在連接 Agent……」

Agent 的行程已經終止。最常見的原因是行程執行在終端機視窗裡，視窗一關就跟著中斷了。

建議把它安裝成系統服務，讓它常駐在背景執行。

顯示「離線」，但 Agent 其實還在執行

連線沒有建立起來。請先到 Agent 的記錄檔裡找「平台不支援」這類錯誤訊息——在部分平台上執行 Agent 時會缺少某些元件，導致配對成功了但連線建不起來。

把 Agent 執行在 Linux、macOS 或容器環境裡，目前是比較穩定的選擇。

連線時斷時續，對話中途會掉線

請先把客戶端與外掛程式都升到最新版本再觀察看看。同時確認這台主機會不會進入休眠——主機一休眠，Agent 的行程也會跟著停止，連線因此中斷，ClawChat 沒有辦法遠端喚醒它。

如果需要讓 Agent 持續在線，把它部署在不會休眠的環境（伺服器、常開的主機或容器）是最徹底的做法。

註冊完成後一直連不上線

通常是連接碼的問題。連接碼只能使用一次，用過即失效，且有有效期限，請不要重複嘗試同一組連接碼。請重新產生連接碼並再次啟用，然後重新啟動 Agent。

啟用後沒收到問候訊息，絕大多數情況是重新啟動這一步沒有生效。

外掛程式安裝失敗

ClawChat 自己的服務可以直接連上，不需要特殊網路環境。安裝失敗通常發生在程式碼託管平台那一側，安裝程式預設會從那裡抓取檔案。

這類情況可以透過「直接從主機安裝」的方式繞過，不建議用強制重裝反覆重試，那走的是同一條會失敗的路。

如果提示找不到 clawchat 相關指令，通常不是指令名稱打錯，而是外掛程式還沒安裝成功。