Troubleshooting

当你发现 OpenClaw 小助手工作不正常时，别着急，我们可以像医生一样给它做检查。首先，用一些简单的命令看看它哪里不舒服。

第一步：快速检查（60秒内完成） 请按顺序在命令行里输入下面这些“咒语”，看看小助手反应好不好：

1. openclaw status：看看小助手的基本情况，比如它连接了哪些聊天通道。
2. openclaw status --all：让小助手做一次全身检查，生成一份详细的报告。
3. openclaw gateway probe：检查一下小助手的“大脑”（网关）能不能联系上。
4. openclaw gateway status：看看“大脑”是不是在好好运行。
5. openclaw doctor：让“医生”诊断一下，有没有严重的配置错误。
6. openclaw channels status --probe：检查所有聊天通道是不是都连接好了。
7. openclaw logs --follow：看看小助手最近在“说”什么，有没有一直喊“疼”（重复的错误）。

如果一切正常，你会看到：所有通道都连接好了，“大脑”在运行，医生也说没发现大问题，日志里也没有一直出现的错误。

遇到特定问题怎么办？

问题一：收到“429”错误 如果你看到一条错误信息说“HTTP 429: rate_limit_error...”，这就像你跟一个叫 Anthropic 的朋友说话太快，它说“等一下，你说太多啦！”。这时候，你需要去另一个专门的页面看看怎么解决。

问题二：安装插件失败 如果你安装插件时，它说“package.json missing openclaw.extensions”，就像你想把一个旧形状的积木塞进新形状的洞里，塞不进去。这个插件用了旧的方法，小助手现在不认了。 要修好它，你需要：

1. 打开插件的 package.json 这个文件。
2. 在里面加上 "openclaw.extensions" 这一部分，告诉小助手插件真正的“身体”在哪里（通常是 ./dist/index.js 这个文件）。
3. 把修好的插件重新发布，然后再用 openclaw plugins install <插件名字> 命令安装一次。

问题三：不知道从哪里开始查？ 别担心，下面有一棵“问题树”，你可以像玩选择游戏一样，根据小助手的症状选择方向：

• 如果它不回复消息，就去“No replies”部分查。
• 如果控制面板连不上，就去“Dashboard or Control UI will not connect”部分。
• 如果它的“大脑”（网关）启动不了，就去“Gateway will not start”部分。
• 如果通道连上了但消息发不出去，就去“Channel connects but messages do not flow”部分。
• 如果定时任务或心跳没执行，就去“Cron or heartbeat”部分。
• 如果节点配对了但工具（像拍照、录屏）用不了，就去“Node is paired but tool fails”部分。
• 如果浏览器工具坏了，就去“Browser tool fails”部分。

每个部分里都有更详细的检查步骤和常见错误提示，帮助你一步步找到问题所在。