Troubleshooting
故障排除
这一页面向“已经坏了”的场景。你不需要先理解所有概念，只要按命令顺序做检查，再根据症状跳到对应分支即可。
最初的六十秒
按顺序运行
openclaw status
openclaw status --all
openclaw gateway probe
openclaw logs --follow
openclaw doctorGateway 可达后补充
当“已配置”不代表“工作正常”时，继续做深探测。
openclaw status --deep常见症状 → 处理方向
openclaw: command not found
通常是 Node / npm PATH 问题。先确认 shell 里的 Node 安装路径，再重新打开终端或重装 CLI。
安装程序失败或卡住
用详细模式重新跑安装脚本，带上 --verbose 看完整输出。
Gateway unauthorized / 持续重连
多半是 token、URL、远程模式或 HTTP 安全上下文问题。优先去 Gateway 故障页继续深排。
模型失败 / all models failed
先确认 openclaw models status，再看当前智能体是否真的拥有相应 provider 的认证配置。
服务看似在跑但没响应
同时看 gateway status、gateway probe 与日志，确认不是“监管器加载了，但 Gateway 根本没监听”。
文档入口异常或 SSL 错误
如果你碰到 ISP 级过滤或 SSL 异常，先换网络、移动热点或 VPN 复核是不是本地网络策略问题。
提交问题前
优先附上 openclaw status --all 的输出。它相对安全、可粘贴，而且包含了多数一线排障需要的上下文。
如果你能补一段 openclaw logs --follow 的相关日志尾部，定位速度会明显更快。
怀疑配置问题时，不要直接贴完整明文 token；先确认是否已经被工具做了脱敏。