诊断命令速查:从状态摘要到深度探测
出问题时先跑对命令,比盲目重启有用得多。官方 FAQ 把这套流程叫「出现故障时的最初六十秒」。
六条命令按序上
| 命令 | 看什么 |
|---|---|
openclaw status | 本地快照:系统、网关可达性、智能体/会话、提供商问题 |
openclaw status --all | 可安全分享的完整诊断(含日志尾部,令牌已脱敏) |
openclaw gateway status | 守护进程与端口:监督运行时、RPC 可达性、探测目标 |
openclaw status --deep | 实时健康探测,支持时连带各渠道探测 |
openclaw logs --follow | 跟踪最新日志;RPC 不可用时直接 tail 文件日志 |
openclaw doctor | 修复/迁移配置与状态,然后跑健康检查 |
文件日志在 /tmp/openclaw/ 下按日期滚动,命名形如 openclaw-年-月-日.log;使用命名配置时会带后缀。想要机器可读的完整快照:openclaw health --json。
六十条的比喻怎么用
别被「六十秒」吓到——实际排查就是个漏斗:
- 先看 status:多数问题在这层就现形(网关没起、提供商没配)。
- 再跟日志:重发一条消息,看它卡在哪一环。
- 最后 doctor:修配置、迁移状态,做完再测一轮。
求助时怎么发材料
去社区问问题时,贴 openclaw status --all 的输出即可——官方设计它就是「可安全分享」的:日志尾部自动脱敏令牌。别直接贴配置文件,密钥会露。