接不上时怎么排查
四种「连接失败」的成因各不相同:持续显示「正在连接」通常是进程已终止;显示离线但进程运行中是连接未建立;时断时续属于稳定性问题;始终未上线多为连接码问题。
请先对照以下四种表现,其成因各不相同。
一直显示「正在连接 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 为好友,通过后再回到该页发送。