🔧 よくある問題の排査
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.json2. 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 logs4. ゲートウェイを再起動：
openclaw gateway restart
まだ解決しませんか？ほとんどの問題はbaseUrlが誤っているか、API Keyがコピーされていないことが原因です。各サービス事業者ページの設定例と照らし合わせて仔細に確認してください。