OPenClawを使ってAI開発をしていると、さまざまなエラーに悩まされることがよくあります。API呼び出しの失敗やアカウントの権限問題など、この記事ではよく発生するエラーコードとそのトラブルシューティング方法をまとめました。役立ててください。
API認証エラー：401と403
401 Unauthorizedが発生した場合、通常はAPIキーが無効または期限切れであることを意味します。まずキーに誤って文字が削除されていないかを確認し、OPenClawコンソールの「API Keys」ページで新しいキーを生成してください。コピーする際、前後のスペースを削除しないよう注意してください。一方、403 Forbiddenは、そのキーに特定のインターフェースへのアクセス権限がないことを示しています。管理画面でロールの権限設定を確認し、アカウントに適切なScopeが割り当てられているか確認してください。
リクエストタイムアウトとネットワーク問題：408と429
408 Request Timeoutは、サーバーがリクエストを待機する時間が長すぎることを示します。主な原因はネットワークの遅延やリクエストボディのサイズが大きすぎることです。1回のリクエストデータ量は2MB以内に抑え、ネットワークプロキシが安定しているか確認しましょう。429 Too Many Requestsはレート制限に達した場合に発生します。OPenClawではアカウントごとに1分間のリクエスト回数上限が設けられています。この場合、60秒待ってから再試行するか、プランをアップグレードして割り当てを増やし、頻繁なポーリングを避けてください。
サーバー側の異常：500と502
500 Internal Server Errorはサーバー側の一時的な障害です。通常、OPenClawチームが数分以内に修正します。まずstatus.openclaw.comでサービスステータスを確認し、正常であれば再試行してください。継続してエラーが発生する場合は、完全なリクエストログを添付してテクニカルサポートに連絡してください。502 Bad Gatewayはゲートウェイ層の問題が原因であることが多く、5分程度待ってから再試行すれば通常は復旧します。ページを何度もリロードしないでください。
アカウントロックとサブスクリプション制限
ログイン後にAccount Lockedと表示された場合、パスワードの複数回誤入力や異常なログインが検出された可能性が高いです。登録済みのメールアドレスを使用してパスワードをリセットし、最近のログイン履歴を確認してください。また、一部の高度な機能は特定のサブスクリプションが必要です。400 Bad Requestに「insufficient plan」というメッセージが含まれている場合、現在のプランではその操作をサポートしていないことを示しています。Proバージョンへのアップグレードを検討してください。
日常のトラブル回避のコツ
コードや設定を変更した後は、毎回小規模なテストを実行する習慣をつけることで、多くのエラーを未然に防げます。また、OPenClaw SDKは常に最新バージョンを維持してください。古いバージョンではインターフェース変更により予期しないエラーが発生する可能性があります。理解できないエラーに遭遇した場合は、公式ドキュメントのError Code説明ページを直接参照すると、最も正確な説明が得られます。
