跳转到主要内容

故障排查

常见 AI 报错排查指南:429、403、500 等错误码的含义,限流与配额错误,登录和验证问题,以及经过验证的解决步骤。
  • 27 篇文章
  • 最近更新 2026年10月10日
OpenClaw 从最早失败连接定位网关凭证、模型认证和实际运行环境的示意

OpenClaw API Key 错误怎么修:401、No API Key、429 与网关认证

OpenClaw API Key 错误先看最早失败的请求:缺少服务商凭证才补认证,Gateway 令牌或设备权限失败就修客户端连接,429 则区分入口认证限流与模型配额。对照实际 Gateway 进程、agent 和会话模型修复,再从已完成工作继续验证。

27 分钟
API 400 消息角色不受支持的排查示意

修复 API 400 角色不受支持错误,不破坏系统提示词

system 角色被拒绝,先查最终请求走的是 Anthropic Messages、Chat Completions 还是 Responses。初始指令、对话中追加的指令和工具结果各有对应字段与位置;修好结构后,还要验证指令约束和完整任务。

20 分钟
OpenClaw invalid beta flag 的具体功能、提供商与请求头来源排查

OpenClaw Invalid Beta Flag:定位被拒绝的功能与提供商配置

OpenClaw 报 invalid beta flag,先查具体 beta 名称、实际请求地址和请求头从哪里加入;只修复被拒绝的功能或配置。配置校验通过与 Gateway 正常运行都不能证明模型调用恢复,最后必须在原来的 agent、会话和提供商上验证完整响应。

19 分钟
OpenClaw 429 的模型限额、下载、冷却与备用路线排查

OpenClaw 429 限流怎么恢复?等待、冷却与回退排查

遇到 OpenClaw 429,先停止反复提交整条任务。临时限流按 Retry-After 等待并降低并发;套餐周期或余额耗尽要等实际重置或恢复访问。ClawHub 下载单独排查,重启不会清除持久冷却,已配置的备用模型也要满足当前会话的回退规则。

22 分钟
429 RESOURCE_EXHAUSTED 的停止条件与短时限流有限重试分流

Nano Banana Pro RESOURCE_EXHAUSTED 429:排查与 Python、Node.js 恢复代码

Nano Banana Pro 的 429 不能一律靠重试解决:零额度、每日上限和计费阻塞应先停止,短时限流才按服务端最低等待时间重试。下面的 Python、Node.js 程序限制次数与请求等待总时长,验证并保存图片,续跑时跳过已确认完成的任务。

18 分钟