OpenClaw 使用教程

Appearance

案例 04｜排查为什么没跑起来：从 status 到 logs（SOP） ​

目标 ​

当 OpenClaw/某个工具“看起来没反应”时，用最短路径定位问题在：环境 / 配置 / 权限 / 外部服务。

你对小艺说（输入模板） ​

我这边 XX 功能不工作了（现象：……）。你按标准流程帮我排查。

你补充 3 个信息，速度会快很多：

  • 你在哪个渠道（webchat/telegram/…）
  • 最近一次正常是什么时候
  • 有无报错截图/日志片段

排查步骤（标准剧本） ​

  1. 整体状态：
bash
openclaw status --deep
  1. 跟随日志（最重要）：
bash
openclaw logs --follow
  1. Gateway：
bash
openclaw gateway status
openclaw gateway probe
  1. 渠道：
bash
openclaw channels status
openclaw channels logs --channel all
  1. 模型：
bash
openclaw models status
openclaw models status --probe
  1. 记忆（如果相关）：
bash
openclaw memory status --deep

验收（输出应该是什么样） ​

  • [ ] 明确定位故障层级（环境/配置/权限/外部服务）
  • [ ] 给出下一步动作（具体到命令/配置项/你需要补充的信息）

常见坑 ​

  • Control UI unauthorized：大概率缺 gateway token（URL 带 /?token=...）
  • 看起来没触发：先去 Cron run history 或 Sessions 工具日志确认是否真的没跑