OpenClaw 🦞

故障排除

故障排除

如果只有 2 分钟，使用此页面作为分类前门。

前 60 秒

按顺序运行这个精确的阶梯：

openclaw status
openclaw status --all
openclaw gateway probe
openclaw gateway status
openclaw doctor
openclaw channels status --probe
openclaw logs --follow

一行中的良好输出：

  • openclaw status → 显示配置的频道，没有明显的认证错误。
  • openclaw status --all → 完整报告存在且可分享。
  • openclaw gateway probe → 预期的 gateway 目标可达。
  • openclaw gateway status → Runtime: running 和 RPC probe: ok。
  • openclaw doctor → 没有阻塞配置/服务错误。
  • openclaw channels status --probe → 频道报告 connected 或 ready。
  • openclaw logs --follow → 稳定活动，没有重复的致命错误。

Anthropic 长上下文 429

如果看到： HTTP 429: rate_limit_error: Extra usage is required for long context requests， 前往 /gateway/troubleshooting#anthropic-429-extra-usage-required-for-long-context。

插件安装失败，缺少 openclaw extensions

如果安装失败并显示 package.json missing openclaw.extensions，插件包使用 OpenClaw 不再接受的旧形状。

在插件包中修复：

  1. 添加 openclaw.extensions 到 package.json。
  2. 将条目指向构建的运行时文件（通常是 ./dist/index.js）。
  3. 重新发布插件并再次运行 openclaw plugins install <npm-spec>。

示例：

{
  "name": "@openclaw/my-plugin",
  "version": "1.2.3",
  "openclaw": {
    "extensions": ["./dist/index.js"]
  }
}

参考：/tools/plugin#distribution-npm

决策树

flowchart TD
  A[OpenClaw 不工作] --> B{什么首先中断}
  B --> C[没有回复]
  B --> D[仪表板或 Control UI 无法连接]
  B --> E[Gateway 无法启动或服务未运行]
  B --> F[频道连接但消息不流动]
  B --> G[Cron 或心跳未触发或未传递]
  B --> H[Node 已配对但相机 canvas 屏幕执行失败]
  B --> I[浏览器工具失败]

  C --> C1[/没有回复部分/]
  D --> D1[/Control UI 部分/]
  E --> E1[/Gateway 部分/]
  F --> F1[/频道流部分/]
  G --> G1[/自动化部分/]
  H --> H1[/Node 工具部分/]
  I --> I1[/浏览器部分/]