OPenClaw使用中に、さまざまなエラーメッセージに遭遇することがあります。本記事では、ユーザーに最も多いエラーコードをログイン認証、ネットワーク接続、API呼び出しなどのシナリオ別に整理し、すぐに実践できる解決方法を紹介します。正常な使用状態に素早く戻すためにご活用ください。
ログイン・認証系エラー：401と403
401 Unauthorizedが表示された場合、APIキーが無効または期限切れである可能性が高いです。OPenClawコンソールにアクセスし、新しいAPIキーを再生成してください。コード内で正しくキー文字列が設定されているか、大文字小文字が区別される点、コピー時に余分なスペースが入っていない点も確認しましょう。
403 Forbiddenは、アカウントの権限が現在の操作を実行するのに不十分であることを示します。無料版ユーザーが有料機能にアクセスしようとした場合によく発生します。サブスクリプションの状態を確認し、アップグレードが必要であればアカウントセンターからプランを切り替えてください。すでに加入しているのにエラーが出る場合は、カスタマーサポートに連絡して権限のリフレッシュを依頼すれば解決します。
ネットワーク・接続系エラー：TimeoutとConnection Reset
リクエストのタイムアウト（Timeout）は、主にローカルネットワークの不安定さやOPenClawサーバーの一時的な混雑が原因です。まずはネットワーク環境を変更し、Wi-Fiからモバイルデータに切り替えてみてください。それでも解決しない場合は、リクエストのタイムアウト設定をデフォルトの30秒から60秒に延長することを検討しましょう。
Connection Reset（接続リセット）は、通信途中で接続が切断されたことを意味します。多くの場合、ファイアウォールやプロキシがOPenClawのIPレンジをブロックしているのが原因です。OPenClawの公式ドメインをホワイトリストに追加し、VPNをオフにするかプロキシルールを調整してください。企業ユーザーは、送信セキュリティポリシーが外部APIリクエストを制限していないかも確認しましょう。
API呼び出しエラー：429と500
429 Too Many Requestsは最も一般的なレート制限エラーです。OPenClawはAPI呼び出しの頻度に制限を設けており、無料版では1分間に最大20回、有料版ではプランに応じて制限が引き上げられます。対策としてはリクエスト頻度を下げるか、指数バックオフ（Exponential Backoff）リトライ機構を実装することです。業務で高頻度のリクエストが必要な場合は、上位プランにアップグレードしてより高いクォータを取得することをおすすめします。
500 Internal Server Errorは、OPenClawサーバー側で一時的な障害が発生していることを示します。まずはOPenClaw公式ステータスページを確認し、メンテナンス中でないかご確認ください。一時的な問題であれば、3～5分待ってから再試行すると復旧します。継続してエラーが出る場合は、サポートチケットを送信し、リクエストログの完全な内容を添付してください。技術担当者が原因を特定しやすくなります。なお、レート制限を誘発しないよう、短時間に同じリクエストを繰り返し送信しないように注意しましょう。
アカウントロック・異常ログイン通知
誤ったパスワードを連続して入力したり、普段利用していない地域からログインしたりすると、OPenClawのセキュリティ保護機能が作動し、アカウントが一時的にロックされることがあります。この場合、登録メールアドレスに送信されるロック解除リンクを使用するか、SMS認証コードでログインを再設定してください。認証コードが届かない場合は、迷惑メールフォルダを確認し、電話番号が正しく登録されており、料金未納がないかをチェックしましょう。長期間使用していないリスクの高いアカウントは、二段階認証（2FA）を有効にすることで誤ロックの確率を減らせます。
