OpenClaw 使用教程

Appearance

案例 C｜运维/开发：排错剧本（status / logs / probe） ​

目标：把“排错”变成一套可复用的剧本，而不是每次靠经验。

一句话原则 ​

  • 先确认整体是否活着（status）
  • 再看日志（logs）
  • 最后做探测（probe）

1) 第一层：整体状态 ​

bash
openclaw status --deep

你想看到的是：

  • Gateway running
  • 端口/健康检查正常
  • 模型 provider 可用

2) 第二层：日志（90% 的答案在这里） ​

bash
openclaw logs --follow

常见关键词：

  • unauthorized（通常是 token/权限）
  • ECONNREFUSED（服务没起来/端口不通）
  • rate limit（额度/频控）

3) 第三层：Gateway 探测 ​

bash
openclaw gateway status
openclaw gateway probe

probe 用于快速确认：本机/局域网/远端访问链路是否通。

4) 控制台/Control UI 问题的最短修复 ​

如果你遇到：

  • 页面异常/乱码
  • 报：unauthorized: gateway token missing

优先按 token 方案修复：

  • http://127.0.0.1:18789/?token=<gateway.auth.token>

5) 给 AI 的排错提问模板（高命中） ​

把关键日志贴出来，并这样问：

你是 OpenClaw 运维助手。请按“可能性从高到低”列出 3 个原因，并为每个原因给：

  1. 验证命令
  2. 修复步骤
  3. 风险提醒

下一篇 ​

  • 案例 D｜内容工厂：批次交付流水线（build + deploy）