跳转到主要内容

故障排查

常见 AI 报错排查指南:429、403、500 等错误码的含义,限流与配额错误,登录和验证问题,以及经过验证的解决步骤。
  • 39 篇文章
  • 最近更新 2026年11月7日
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 分钟