openclawapp 中文文档 下载 App

诊断命令速查:从状态摘要到深度探测

出问题时先跑对命令,比盲目重启有用得多。官方 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。

六十条的比喻怎么用

别被「六十秒」吓到——实际排查就是个漏斗:

  1. 先看 status:多数问题在这层就现形(网关没起、提供商没配)。
  2. 再跟日志:重发一条消息,看它卡在哪一环。
  3. 最后 doctor:修配置、迁移状态,做完再测一轮。

求助时怎么发材料

去社区问问题时,贴 openclaw status --all 的输出即可——官方设计它就是「可安全分享」的:日志尾部自动脱敏令牌。别直接贴配置文件,密钥会露。

每类问题先看哪篇