Skip to main content

​
故障排查

如果您只有 2 分钟，请使用此页面作为分诊前门。

​
前 60 秒

按顺序运行以下命令： 
openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow
良好输出一览：
  • openclaw status → 显示已配置的频道且无明显认证错误
  • openclaw status --all → 完整报告已生成且可共享
  • openclaw gateway probe → 目标网关可访问
  • openclaw gateway status → Runtime: running 和 RPC probe: ok
  • openclaw doctor → 无阻塞配置/服务错误
  • openclaw channels status --probe → 频道状态显示 connected 或 ready
  • openclaw logs --follow → 活跃稳定，无重复致命错误

​
常见问题

​
无响应

openclaw status
openclaw gateway status
openclaw channels status --probe
openclaw pairing list --channel <channel>
openclaw logs --follow
良好输出表现为：
  • Runtime: running
  • RPC probe: ok
  • 在 channels status --probe 中频道显示 connected/ready
  • 发送者显示已批准

​
仪表盘或控制界面无法连接

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
常见日志特征：
  • device identity required → HTTP/非安全上下文无法完成设备认证
  • unauthorized / 重新连接循环 → 令牌/密码错误或认证模式不匹配

​
Gateway 无法启动或服务已安装但未运行

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
常见日志特征：
  • Gateway start blocked: set gateway.mode=local → 网关模式未设置
  • refusing to bind gateway ... without auth → 非回环地址绑定缺少令牌/密码
  • another gateway instance is already listening → 端口已被占用

​
频道连接成功但消息未流通

openclaw status
openclaw logs --follow
openclaw channels status --probe
常见日志特征：
  • mention required → 群组提及限制阻止了消息处理
  • pairing / pending → 私信发送者尚未批准

​
相关文档