教程
OpenClaw 故障排查手册：按层定位，不盲改配置
提供标准排障顺序和提交支持前的信息清单。
继续查看
安装、排障和深入阅读最常用的入口都在这里。
标准排查顺序
- 服务是否运行
- 通道是否可达
- 模型是否可调用
- 日志是否有明显错误码
命令清单
openclaw status
openclaw health
openclaw channels list
openclaw models list
openclaw logs --tail 150
常见错误码对照
| 错误码 | 常见原因 | 优先动作 |
|---|---|---|
| 401 | Key 错误/过期 | 重换 Key，重启服务 |
| 403 | 权限不足 | 检查组织/项目权限 |
| 429 | 请求超限 | 限流或切备用模型 |
| timeout | 网络波动 | 加重试与超时策略 |
提交支持前准备的信息
- 当前版本号
- 关键报错日志片段
- 最近一次变更内容
- 所用模型和通道名称
这样能显著缩短定位时间。