推荐替代
推荐使用原生国产开源替代：Lingti-Bot
帮助
故障排查
按照 60 秒快速检查 → 服务状态 → 渠道问题的顺序排查。
60 秒快速检查
clawdbot status
clawdbot status --all
clawdbot gateway probe
clawdbot logs --follow如果命令找不到，请先确认 PATH 或重新安装 CLI。
服务未运行 / 无法连接
- 检查并修复依赖：
clawdbot doctor - 重启网关：
clawdbot gateway restart - 查看网关详细日志：
clawdbot gateway --verbose
控制台无法访问
- 确认网关端口：
clawdbot config get gateway.http.port - 确认 WebSocket 端口：
clawdbot config get gateway.websocket.port - 检查防火墙/Tailnet 访问策略与 Token 设置
授权失败 / 未授权
- 确保
CLAWDBOT_GATEWAY_TOKEN与控制台connect.params.auth.token一致 - 确认
~/.clawdbot/agents/<agentId>/agent/auth-profiles.json存在有效配置 - 服务器无界面时，可在本地完成 OAuth 再复制到网关主机
渠道登录异常（WhatsApp / Telegram 等）
- 重新登录渠道：
clawdbot channels login - 确保同一号码只绑定在一个网关上
- 必要时清理状态目录：
rm -rf ~/.clawdbot（会重置所有配置）
仍未解决？
- 收集诊断信息：
clawdbot doctor --json+clawdbot status --json - 附上日志尾部：
clawdbot logs --last 2000 - 描述复现步骤与期望结果
中文交流群
扫码加入中文交流群，分享网关搭建、渠道接入与运维经验。
