OpenClaw API Key 常见问题排查

🔧 常见问题排查

API Key 配好了但是报错？别急，常见问题都在这里了。

常见错误及解决方案

❌ 401 Unauthorized / Invalid API Key

原因：API Key 无效或过期。

检查密钥是否复制完整（没有多余空格或缺少字符）
确认密钥没有被禁用或删除
确认 baseUrl 和 API Key 匹配（别把 OpenAI 的 Key 填到 Anthropic 的地址里）
Coding Plan 的 Key 要用 Coding Plan 的 baseUrl，别搞混

❌ 429 Too Many Requests / Rate Limited

原因：请求太频繁，超过了速率限制。

等一会儿再试
如果经常被限速，考虑升级到 Coding Plan（速率更高）
或者配置多个 provider，分散请求

❌ 402 Payment Required / Insufficient Balance

原因：余额不足。

去对应平台充值
检查是否有未支付的账单
免费额度是否已用完

❌ Connection Timeout / Network Error

原因：网络连接问题。

国际服务商（OpenAI、Anthropic、Gemini）在国内可能需要代理
国内服务商（DeepSeek、MiniMax 等）应该直连没问题
检查 baseUrl 是否正确，有没有拼写错误
尝试 curl 命令测试连通性

❌ 400 Bad Request / Invalid Model

原因：模型名称写错了，或者你的账号没有该模型的访问权限。

检查 models 配置中的模型名是否正确
确认你的账号/方案是否支持该模型
参考各服务商页面的可用模型列表

调试技巧

1. 检查当前配置：

cat ~/.openclaw/openclaw.json

2. 测试 API 连通性：

# 测试 DeepSeek
curl -s https://api.deepseek.com/v1/models -H "Authorization: Bearer sk-你的密钥"

# 测试 OpenAI
curl -s https://api.openai.com/v1/models -H "Authorization: Bearer sk-你的密钥"

3. 查看 OpenClaw 日志：

openclaw logs

4. 重启网关：

openclaw gateway restart

💡 还是搞不定？大部分问题都是 baseUrl 写错或者 API Key 复制不完整导致的。仔细对照一下各服务商页面的配置示例。