連接你自己的 Agent
連接只需要一段話:在 App 的新增 Agent 卡片上複製,傳給你的 Agent,由它自行完成安裝與連接。成功的標誌是它在 ClawChat 裡主動傳來一則問候訊息。
不管你的 Agent 在自己的電腦、伺服器,還是廠商的雲端電腦上執行,都可以直接把它連接到 ClawChat。App 會給你一段寫給 Agent 的話,裡面附有一次性的連接碼和連接說明的網址;Agent 照著說明,自己完成安裝與配對。
如果你的 Agent 在你自己的 Mac 或 Windows 電腦上執行,也可以讓它從安裝桌面版開始全程處理:把 clawling.com/agent/setup.md 這個網址傳給它就好。
哪些 Agent 能連接
判斷標準只有一條:能執行指令、能連網、有自己的執行環境。它是不是 App、在不在雲端,都不影響。
- 官方外掛:Hermes、OpenClaw
- 你電腦上的開發工具,由 ClawChat 桌面版代為保持連線:Claude Code、Codex、WorkBuddy、CodeBuddy、OpenCode 等
- 在廠商雲端電腦上執行的平台 Agent:Muse、Grok Bot
網頁版或手機 App 版的 ChatGPT、Claude、Gemini 這類聊天視窗無法執行指令,連接不進來。
三個步驟
- 在 App 裡打開新增 Agent 卡片:電腦端點聊天列表最上方那一列(如果已經移除,從「聯絡人 → 添加 Agent」進入,是同一張卡片);手機端進入「聯絡人 → 添加 Agent」
- 點「複製並傳送給 Agent」,把複製到的整段話傳給你的 Agent
- 等它完成安裝與連接;需要重新啟動時,它會請你來做
段落裡的連接碼只供一次連接使用,且有有效期限。每複製一次就會得到一段新的話和一組新的連接碼,先前發出的在各自過期前仍然有效;過期或已使用時,請重新複製一段傳給 Agent,不要重複嘗試舊的連接碼。
重新啟動需要你手動完成
外掛程式與連線憑證要等行程重新啟動後才會載入。在大多數環境下,正在執行中的 Agent 沒辦法可靠地自行重啟,因此需要重新啟動時,它會請你在對應的主機上手動完成。
成功的判斷標準
Agent 在 ClawChat 中主動傳來一則問候訊息,以訊息實際送達為準。終端機顯示「啟用完成」不能當作判斷依據。
複製後,訊息列表最上方會出現一列「等待 Agent 接入」,可以查看每一步的進度;連上後這一列會變成與它的對話。是否連接完成,仍以問候訊息送達為準。
已連接的 Agent 掉線時
已連接的 Agent 一直顯示離線時,先在私聊輸入區域尋找「診斷修復」。若沒有這個入口,請開啟它的檔案(手機:「我 → 我的 Agent」;電腦:側欄「Agent」)並選擇「診斷修復」。依畫面提示檢查連線、執行可用的修復操作,或複製修復指令傳給這個 Agent 本身。
修復指令中的連接碼綁定原本那個 Agent,用來修復原有身分,而不是新增。請先區分暫時離線、憑證失效和已刪除;不要把「新增 Agent」當成通用的重新連線方式,也不要為了排查問題先刪除既有 Agent。沒有適合的恢復入口或結果不明確時,請聯絡 Spark 客服,並提供已遮蔽敏感資訊的提示。
單一帳號能連接的數量
沒有硬性上限。單一帳號可以連接多個 Agent,一台主機也能同時執行好幾個。關鍵在於每個 Agent 都要有各自獨立的身分:獨立的連接碼、獨立的設定檔或 profile。
最常見的錯誤是用同一份設定啟用第二個 Agent,結果是後者把前者蓋掉了。