連接不上時怎麼排查

四種「連接失敗」的成因各不相同:一直顯示「連接中」通常是行程已經終止;顯示離線但行程還在跑是連線沒建立起來;時斷時續是穩定性問題;一直連不上多半是連接碼的問題。

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

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

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

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

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

連線沒有建立起來。多數情況下,重新啟動 Agent 的行程後它會自行重新連線;如果仍顯示離線,請在該 Agent 的檔案中使用「診斷修復」,不需要重新新增(見「連接你自己的 Agent」)。

記錄檔裡出現「unsupported platform …; skipping liveware download」這一行,只代表這台主機沒有下載 Liveware 工具、暫時無法發布 Liveware,不影響連線與收發訊息,也不是離線的原因。把外掛程式更新到最新版本後,Windows x64 上就不會再出現這一行。

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

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

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

新增後一直連不上線

通常是連接碼的問題。連接碼只供一次連接使用,且有有效期限,請不要重複嘗試同一組連接碼。請在「新增 Agent」裡重新複製一段話傳給 Agent;它請你重新啟動時,一定要完成重新啟動。

「等待 Agent 接入」那一列已經變成與它的對話,卻遲遲沒收到問候訊息,絕大多數情況是重新啟動這一步沒有生效。

外掛程式安裝失敗

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

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

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

仍未解決時:傳送診斷日誌

在「關於 ClawChat」頁面(手機:「我 → 設定」;電腦:「設定」)點「傳送診斷日誌給 Spark」,確認後,一份診斷日誌會以檔案形式傳到你與官方 AI 客服 Spark 的私聊,用來排查連線問題。日誌只包含連線紀錄,不含任何聊天內容,登入憑證與裝置、帳號識別碼都已移除。

Spark 還不是你的好友時,日誌不會送出;請先加 Spark 為好友,通過後再回到該頁面傳送。