OpenClaw Gateway 故障排除完全指南

本页面是详细的故障排除手册。如果你想快速诊断，先从 /help/troubleshooting 开始。

命令阶梯

按顺序运行以下命令：

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

正常的健康信号：

• openclaw gateway status 显示 Runtime: running 和 RPC probe: ok
• openclaw doctor 报告没有阻塞性配置/服务问题
• openclaw channels status --probe 显示已连接/就绪的渠道

Anthropic 429 错误 – 长上下文需要额外使用

当日志/错误包含：HTTP 429: rate_limit_error: Extra usage is required for long context requests

检查：

openclaw logs --follow
openclaw models status
openclaw config get agents.defaults.models

查找：

• 选定的 Anthropic Opus/Sonnet 模型是否有 params.context1m: true
• 当前 Anthropic 凭证是否有长上下文使用资格
• 请求是否仅在需要 1M beta 路径的长会话/模型运行时失败

修复选项：

1. 为该模型禁用 context1m，回退到正常上下文窗口
2. 使用有账单的 Anthropic API 密钥，或在订阅账户上启用 Anthropic Extra Usage
3. 配置备用模型，以便在 Anthropic 长上下文请求被拒绝时继续运行

没有回复

如果渠道已上线但没有任何回复，先检查路由和策略，再考虑重新连接。

openclaw status
openclaw channels status --probe
openclaw pairing list --channel [channel]
openclaw config get channels
openclaw logs --follow

查找：

• 私信发送者的配对待处理
• 群组提及门控（requireMention, mentionPatterns）
• 渠道/群组白名单不匹配

常见特征：

• drop guild message (mention required → 群组消息被忽略直到被提及
• pairing request → 发送者需要批准
• blocked / allowlist → 发送者/渠道被策略过滤

Dashboard/Control UI 无法连接

当 Dashboard/Control UI 无法连接时，验证 URL、认证模式和安全的上下文假设。

openclaw gateway status
openclaw status
openclaw logs --follow
openclaw doctor
openclaw gateway status --json

查找：

• 正确的探测 URL 和 Dashboard URL
• 客户端和网关之间的认证模式/令牌不匹配
• HTTP 使用中设备身份是…

快速诊断命令

遇到问题时，按顺序运行：

1. openclaw status — 快速状态概览
2. openclaw status --all — 完整诊断（可安全分享）
3. openclaw status --deep — 深度检查（包括模型探测）

相关资源

• 渠道故障排除
• 配对与安全
• 常见问题

更多详细信息请访问：OpenClaw 官方故障排除文档