模型问题
API Key 无效或过期:模型无法连接
macOSWindowsLinuxDocker
症状
发送消息后无回复,或报错:
Error: 401 Unauthorized - Invalid API key
Error: API key expired or revoked
原因
- API Key 输入错误 — 复制时多了空格或少了字符
- Key 已过期 — 免费额度用完或 Key 被撤销
- 模型提供商选错 — 用了 OpenAI 的 Key 但选了 Anthropic
解法
第一步:确认 Key 格式正确
# 查看当前配置
cat ~/.openclaw/openclaw.json | grep -A 5 "model"
各提供商 Key 格式:
- Anthropic (Claude):
sk-ant-api03-... - OpenAI (GPT):
sk-proj-...或sk-... - DeepSeek:
sk-...
第二步:重新配置 Key
openclaw config set model.apiKey "你的新Key"
openclaw gateway restart
第三步:测试连接
openclaw doctor
# 应显示 Model connection: ✅
验证修复
发送一条简单消息,确认能收到回复。