OpenClaw 使用教程

Appearance

常见问题排查（推荐顺序｜SOP） ​

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

0) 先问三句话（减少盲查） ​

  1. 你在哪个渠道？（webchat / telegram / feishu / …）
  2. 是“完全不能用”还是“某个功能不工作”？
  3. 最近一次正常是什么时候？中间改过什么？

1) 先看整体状态（第一优先级） ​

bash
openclaw status --deep

你重点看：

  • Gateway 是否 Running
  • Node 版本/运行环境是否异常
  • 是否提示模型/鉴权不可用

2) 看日志（最重要） ​

bash
openclaw logs --follow

经验：

  • 80% 的问题日志里都有“第一现场证据”
  • 把最关键的 20 行贴出来，通常就能定位

3) Gateway 相关 ​

bash
openclaw gateway status
openclaw gateway probe

常见现象：

  • 能启动但 UI 连不上：多半是 bind/端口/token

4) Channels（渠道）相关 ​

bash
openclaw channels status
openclaw channels logs --channel all

常见现象：

  • 群里不回：是否需要 @、群策略是否禁用、机器人是否在群里

5) Models（模型/鉴权）相关 ​

bash
openclaw models status
openclaw models status --probe

--probe 会发真实请求，可能消耗额度；只有在需要时再用。

常见现象：

  • status 正常但 probe 失败：通常是 provider token/网络/额度

6) Memory（记忆）相关（如果问题涉及“记不住/搜不到”） ​

bash
openclaw memory status --deep
openclaw memory index --force

7) Control UI / Dashboard 常见坑 ​

  • unauthorized / token missing：URL 带 /?token=<gateway.auth.token>
  • 页面空白：先看浏览器控制台 + openclaw logs --follow

详见：

8) 验收（你应该得到的结论） ​

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