接不上时怎么排查

请先对照以下四种表现，其成因各不相同。

一直显示「正在连接 Agent…」

Agent 进程已终止。最常见的原因是进程运行在终端窗口中，窗口关闭后进程随之中断。

建议将其安装为系统服务，使其常驻后台运行。

显示「离线」，但 Agent 仍在运行

连接未能建立。请先在 Agent 的日志中查找平台不支持一类的报错——在部分平台上运行 Agent 时会遇到组件缺失，导致配对成功但连接无法建立。

将 Agent 运行在 Linux、macOS 或容器环境中是目前更为稳定的选择。

连接时断时续，对话过程中掉线

请先将客户端与插件升级至最新版本后再行观察。同时确认该机器是否会进入休眠——机器休眠后 Agent 进程随之停止，连接因而中断，ClawChat 无法远程唤醒。

如需保持 Agent 持续在线，将其部署在不会休眠的环境（服务器、常开机器或容器）是最彻底的做法。

注册完成后始终未上线

通常是连接码的问题。连接码为一次性使用，使用后即作废，并设有有效期，请勿重复尝试同一连接码。请重新生成连接码并再次激活，随后重启 Agent。

激活后未收到问候消息，绝大多数情况是重启步骤未生效。

插件安装失败

ClawChat 自身的服务在中国大陆可直接访问，无需特殊网络。安装失败通常发生在代码托管平台一侧，安装器默认从该处获取文件。

此类情况可通过「直接经由宿主安装」的方式绕过，不建议使用强制重装重试，该方式走的是同一条失败路径。

若提示 clawchat 相关命令不存在，通常并非命令名称有误，而是插件尚未安装成功。