帮助
故障排除
如果你只有两分钟，可以用本页面作为快速诊断入口。
前 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→ 预期的网关目标可达。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 扩展
如果安装失败并提示 package.json missing openclaw.extensions，说明插件包使用了 OpenClaw 不再支持的旧格式。在插件包中修复：
- 在
package.json中添加openclaw.extensions。 - 将条目指向构建后的运行时文件（通常是
./dist/index.js）。 - 重新发布插件，然后再次运行
openclaw plugins install <npm-spec>。
示例：
{
"name": "@openclaw/my-plugin",
"version": "1.2.3",
"openclaw": {
"extensions": ["./dist/index.js"]
}
}
参考：/tools/plugin#distribution-npm