接入你自己的 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,其结果是后者覆盖前者。