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 複製不完整導致的。仔細對照一下各服務商頁面的設定示例。