OPenClawよくある質問：アカウント連携とAPI呼び出しエラー解決ガイド

OPenClawをご利用中、多くのユーザーがアカウント連携の失敗、APIリクエストのタイムアウト、インターフェースエラーなどの問題に直面します。本記事では、頻発するトラブルシナリオとその対処法をまとめ、素早く復旧して同じミスを繰り返さないようにサポートします。

1. アカウント登録・連携に失敗した場合

登録時にメール確認メールがなかなか届かない場合は、まず迷惑メールフォルダを確認してください。それでも見つからない場合は、GmailやOutlookなどの別のメールアドレスで再登録してみてください。サードパーティプラットフォーム（GitHub、Googleなど）との連携時に「認証に失敗しました」というポップアップが表示される場合、通常はブラウザのキャッシュまたはサードパーティアカウントの権限が原因です。Cookieをクリアし、シークレットモードで再度操作することをおすすめします。

連携後に「アカウントが制限されました」と表示される場合、短時間に複数回の連携を行ったことでセキュリティ警戒が発動した可能性があります。この場合は24時間待機し、公式メールアドレスから状況を説明したチケットを提出してください。通常1営業日以内に制限が解除されます。

2. APIキーの呼び出しで頻繁にエラーが発生する場合

リクエストが「401 Unauthorized」を返す場合、APIキーのコピー漏れや有効期限切れである可能性が高いです。OPenClawのコンソールにログインしてキーを再生成し、コード内に余分なスペースが含まれていないことを確認してください。「429 Too Many Requests」エラーが発生した場合は、現在の呼び出し頻度が無料枠の上限を超えていることを示します。リクエスト間隔を長くするか、プランをアップグレードすることをおすすめします。

一部のユーザーから、インターフェースが「500 Internal Server Error」を返すとの報告があります。これは多くの場合、サーバーの一時的な変動によるもので、5分待ってから再試行してください。エラーが続く場合は、予備のエンドポイント（例：api.openclaw.netの代替ドメイン）に切り替え、同時にローカルネットワークが海外IPをブロックしていないか確認してください。

3. モデルの応答異常またはコンテンツの切り捨て

AIの返信が突然短くなったり、同じ文を繰り返すようになった場合は、リクエストパラメータのmax_tokensが小さすぎないか確認してください（512以上を推奨）。出力が文字化けしていたり、日本語と英語が混ざっている場合、入力プロンプトに不正な文字（例：全角カンマや特殊記号）が含まれている可能性があります。これらを半角に置き換えると解決します。

長時間空のコンテンツが返される場合は、コンソールの「使用量統計」で当日の無料枠を使い切っていないか確認してください。無料アカウントは1日500回の呼び出しに制限されており、超過した場合は翌日のリセットを待つか、プロフェッショナルプランに加入して無制限リクエストを有効にしてください。

4. マルチプラットフォーム同期とデータ消失

デバイスを変更した後に会話履歴が同期されない場合は、古いデバイスで正しくログアウトし、新しいデバイスで同じアカウントにログインしていることを確認してください。ブラウザのキャッシュを手動で消去すると、ローカルに保存された会話の下書きが削除されます。重要な会話は定期的にJSONファイルとしてエクスポートしてバックアップすることをおすすめします。

一部のユーザーから、ファミリーグループのメンバーがお互いのプロジェクトを閲覧できないとの報告があります。ファミリーグループの作成者が「会話の共有」権限を有効にしているか確認してください。「設定→権限管理」で該当メンバーにチェックを入れることで解決できます。