OpenClawのモデルフェイルオーバー設定とエラー解決ガイド

開発を進めている最中に API が突然エラーを返したり、レート制限にかかったりするのは本当に困りますよね。そんな時、システムが自動的に別の手段を探して作業を継続してくれたら非常に助かります。

OpenClaw には、まさにそのための「フェイルオーバー」機能が備わっています。しかし、設定が正しくないとエラーメッセージが表示されて戸惑うこともあるかもしれません。この記事では、フェイルオーバーの仕組みと、よくあるエラーの解決方法について解説します。

フェイルオーバーの仕組み

フェイルオーバーは、以下の 2 つの段階で実行されます。

同じプロバイダー内での Auth profile のローテーション
agents.defaults.model.fallbacks に指定された次のモデルへの Model fallback

失敗したプロバイダーにはクールダウン（指数バックオフ）が適用されます。そのため、特定のプロバイダーがレート制限を受けたり一時的にダウンしたりしても、OpenClaw は応答を続けることができます。

「No credentials found for profile ‘anthropic:default’」はどういう意味？

このエラーは、システムが anthropic:default という Auth profile ID を使用しようとしましたが、期待される Auth store 内にその認証情報が見つからなかったことを意味しています。

「No credentials found for profile anthropic:default」の解決チェックリスト

Auth profile の保存場所を確認する
- 現在: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
- 旧仕様: ~/.openclaw/agent/* （openclaw doctor コマンドで移行可能です）
環境変数が Gateway に読み込まれているか確認する
- シェルで ANTHROPIC_API_KEY を設定していても、systemd や launchd 経由で Gateway を実行している場合、その変数が引き継がれないことがあります。
- ~/.openclaw/.env に記述するか、env.shellEnv を有効にしてください。
正しい Agent を編集しているか確認する
- マルチエージェント構成の場合、複数の auth-profiles.json ファイルが存在する可能性があります。
モデルと認証の状態をチェックする
Terminal window
```
openclaw models status
```

「No credentials found for profile anthropic」の解決チェックリスト

このエラーは、実行が特定の Anthropic Auth profile に固定（pinned）されていますが、Gateway がそれを見つけられないことを示しています。

setup-token を使用する場合:

claude setup-token
openclaw models auth setup-token --provider anthropic

代わりに API key を使用する場合:

Gateway ホスト上の ~/.openclaw/.env に ANTHROPIC_API_KEY を記述します。
固定された順序をクリアします。

openclaw models auth order clear --provider anthropic

Gateway ホスト上でコマンドを実行しているか確認する

リモートモードでは、Auth profile は手元のノート PC ではなく、Gateway が動作しているマシン上に保存されます。

なぜ Google Gemini も試行して失敗したのか？

モデルの設定で Google Gemini が fallback として含まれている場合（または Gemini のショートハンドに切り替えた場合）、OpenClaw はモデルのフォールバック中に Gemini を試行します。このとき Google の認証情報が設定されていないと、No API key found for provider "google" というエラーが表示されます。

解決策: Google の認証情報を設定するか、agents.defaults.model.fallbacks から Google のモデルを削除・回避するようにしてください。

設定でお困りの際は、こちらのツールも活用してみてください。 AI Setup Assistant

次のステップ

OpenClaw Expert

まだ解決しませんか？

このページで解決しない場合は、OpenClaw Expertに直接質問してください。