モデルフェイルオーバー

1. 認証プロファイルのローテーション: 同じプロバイダー内で別のアカウント（プロファイル）に切り替える。
2. モデルフォールバック: agents.defaults.model.fallbacks で指定された次のモデルへ切り替える。

​

認証情報の保存 (キーと OAuth)

• シークレット情報（秘密鍵など）は ~/.openclaw/agents/<agentId>/agent/auth-profiles.json に保存されます（旧パス: ~/.openclaw/agent/auth-profiles.json）。
• 構成ファイル (openclaw.json) の auth.profiles や auth.order には、メタデータとルーティング設定のみが含まれます（シークレットは含まれません）。
• 以前の OAuth インポート用ファイル ~/.openclaw/credentials/oauth.json は、初回使用時に auth-profiles.json へインポートされます。

• type: "api_key" → { provider, key }
• type: "oauth" → { provider, access, refresh, expires, email? } (プロバイダーによって projectId や enterpriseUrl が追加されます)

​

プロファイル ID

• デフォルト: メールアドレスが取得できない場合は provider:default。
• メールアドレスありの OAuth: provider:<email> (例: google-antigravity:user@gmail.com)。

​

ローテーションの順序

1. 明示的な構成: auth.order[provider] 設定がある場合。
2. 構成済みのプロファイル: auth.profiles 内の該当プロバイダーの設定。
3. 保存済みのプロファイル: auth-profiles.json 内の該当プロバイダーのエントリ。

• 第一基準: プロファイルの種類 (API キーよりも OAuth を優先)。
• 第二基準: usageStats.lastUsed (同じ種類の中では、最終使用日時が古いものから順に)。
• 例外: クールダウン中または無効化されたプロファイルは、期限切れが近い順に最後尾へ移動されます。

​

セッションの固定 (スティッキーセッション)

• セッションがリセットされたとき (/new または /reset)。
• 圧縮（コンパクション）が完了したとき。
• そのプロファイルがクールダウン状態または無効化されたとき。

​

OAuth が「見失われた」ように見える理由

• auth.order[provider] = ["provider:profileId"] で固定する。
• チャット UI などで /model … コマンドを使用してセッションごとにプロファイルを上書きする。

​

クールダウン (一時停止)

• 1 分
• 5 分
• 25 分
• 1 時間 (上限)

​

支払い関連による無効化

• 無効化の待機期間は 5 時間 から始まり、失敗を繰り返すごとに倍増し、最大 24 時間 となります。
• 該当のプロファイルで 24 時間（設定可能）エラーが発生しなければ、カウンターはリセットされます。

​

モデルフォールバック

​

関連する構成設定

• auth.profiles / auth.order
• auth.cooldowns.billingBackoffHours / auth.cooldowns.billingBackoffHoursByProvider
• auth.cooldowns.billingMaxHours / auth.cooldowns.failureWindowHours
• agents.defaults.model.primary / agents.defaults.model.fallbacks
• agents.defaults.imageModel ルーティング