OPenClawはオープンソースのAIゲートウェイとして知られていますが、利用中にHTTPエラーが発生し、初心者を悩ませることがよくあります。本記事では、頻度の高い403と429のエラーコードに焦点を当て、問題を素早く特定して復旧する方法を紹介します。
403エラーが発生した場合、まずAPIキーが期限切れになっていないか、あるいは有効化されていないかを確認してください。OPenClawのコンソールでキーを再生成できます。生成後は必ずコピーして、設定ファイルにすぐに反映させましょう。また、一部のモデルプロバイダーでは送信元IPをホワイトリストで制限している場合があります。使用しているVPSやプロキシIPが許可リストに含まれていないと、403が返されます。管理画面で「許可IP」設定を確認し、現在の送信元IPを追加すれば解除できます。さらに、無料枠を使い切った後にリクエストを続けると、アカウントが一時的に制限されることもあります。その場合はチャージするか、有料プランに切り替えてください。
429は、短時間に大量のリクエストを送信し、OPenClawが設定したレート制限を超えたことを示します。シンプルな解決策は、送信を一時停止して数十秒待ってから再試行することです。より根本的には、コードに指数バックオフリトライロジックを組み込むとよいでしょう。例えば、失敗するたびに待機時間を2秒、4秒、8秒と段階的に延ばします。同時に、APIの呼び出しプランも確認しましょう。OPenClawの各プランには1分あたりのリクエスト数（RPM）に上限があります。上位プランにアップグレードすると、より高いクォータを得られます。共有APIキーを使用している場合は、他のユーザーと同時に大量のリクエストを実行しないようにし、独立したAPIキーを申請することをおすすめします。
まれに500内部サーバーエラーや502ゲートウェイタイムアウトが発生することがあります。これは通常、OPenClawのバックエンドまたは上流プロバイダー側の問題です。まず5分ほど待ってから再試行し、継続する場合は公式GitHub IssuesやDiscordグループに報告してください。ステータスページ（status.openclaw.com）でサービス停止のアナウンスがないかも確認しましょう。ローカルでデバッグする際は詳細ログを有効にすると、設定の問題かサーバー側の問題かをより早く特定できます。また、OPenClawのイメージを定期的に更新する習慣をつけてください。古いバージョンには既知のバグがあり、これらのエラーを引き起こすことがあります。
