モデル CLI

​

選択順序

• agents.defaults.models は、エイリアスとモデルごとの設定を保存します。エントリを追加しても、モデルオーバーライドは制限されません。
• agents.defaults.modelPolicy.allow は、任意のオーバーライド許可リストです。完全一致の参照、または provider/* や provider/namespace/* のような末尾プレフィックスワイルドカードを使用します。任意のモデルを許可するには、省略するか [] に設定します。エージェントごとの agents.entries.*.modelPolicy.allow は、そのエージェントのデフォルトポリシーを置き換えます。
• agents.defaults.utilityModel は、生成されるダッシュボードセッションタイトル、対応チャネルのスレッド／トピックタイトル、進捗説明など、短い内部タスクに使用する任意の低コストモデルです。エージェントごとの agents.entries.*.utilityModel でオーバーライドできます。未設定の場合、OpenClaw はプライマリプロバイダーが宣言した小規模モデルのデフォルトがあればそれを使用し（OpenAI → gpt-5.6-luna、Anthropic → claude-haiku-4-5）、なければエージェントのプライマリモデルを使用します。ユーティリティルーティングを無効にするには、空文字列に設定します。生成タイトルでは、別個のユーティリティモデルが失敗した場合、プライマリモデルで 1 回再試行します。ダッシュボードタイトルでは、自動ユーティリティ導出と通常のフォールバックが、有効なセッションプロバイダーと認証プロファイルに従います。明示的なユーティリティモデルでは、設定されたプロバイダー／認証が維持されます。ユーティリティモデルが空でも、代替の小規模モデル経路だけが省略され、ダッシュボードタイトルの生成自体は省略されません。ユーティリティタスクは別個のモデル呼び出しであり、制限されたタスク内容が選択したモデルプロバイダーへ送信される場合があります。
• agents.defaults.imageModel は、プライマリモデルが画像を受け付けられない場合にのみ使用されます。
• agents.defaults.pdfModel は、pdf ツールで使用されます。未設定の場合、ツールは imageModel、次に解決済みのセッション／デフォルトモデルへフォールバックします。
• agents.defaults.mediaModels.{image,music,video} は、共有メディア生成ツールを支えます。未設定の場合、各ツールは認証済みのプロバイダーデフォルトを推測します。現在のデフォルトプロバイダーを最初に使用し、次にその機能について登録されている残りのプロバイダーをプロバイダー ID 順に使用します。プロバイダーをまたぐフォールバックは固定のデフォルト動作です。
• エージェントごとの agents.entries.*.model（およびバインディング）は agents.defaults.model をオーバーライドします。マルチエージェントルーティングを参照してください。

​

選択元とフォールバックの厳格性

• agents.defaults.model.primary を変更しても、既存のセッション固定は書き換えられません。ステータスに This session is pinned to X; config primary Y will apply to new/unpinned sessions. と表示される場合は、/model default を実行して固定を解除します。
• CLI のデフォルトモデルおよび許可リストのピッカーは、完全な組み込みカタログではなく models.providers.*.models のみを一覧表示することで、models.mode: "replace" に従います。
• Control UI のモデルピッカーは、設定済みモデルビューを Gateway に要求します。明示的な modelPolicy.allow がある場合、末尾プレフィックスワイルドカードのエントリも含め、それに基づいてフィルタリングします。それ以外の場合は、設定済みモデルと、使用可能な認証を持つプロバイダーが表示されます。完全な組み込みカタログは、明示的な参照ビュー（models.list と view: "all"、または openclaw models list --all）専用です。
• プロバイダーインベントリ UI は、ピッカーの許可リストを適用せず、ソースで定義された models.providers.*.models 行を表示するために、models.list と view: "provider-config" を使用します。

​

クイックモデルポリシー

• 利用できる最新世代の最も強力なモデルをプライマリに設定します。
• コスト／レイテンシー重視のタスクや重要度の低いチャットには、フォールバックを使用します。
• ツール対応エージェントや信頼できない入力では、旧世代または性能の低いモデル階層を避けます。

​

オンボーディング

openclaw onboard

​

「モデルが許可されていません」（および応答が停止する理由）

モデルオーバーライド「provider/model」は agents.defaults.modelPolicy.allow で許可されていません。
「provider/model」、「provider/*」、またはより限定的な「provider/namespace/*」プレフィックスを agents.defaults.modelPolicy.allow に追加するか、任意のモデルを許可するためにリストを削除または空にしてください。

{
  agents: {
    defaults: {
      modelPolicy: {
        allow: ["openai/*", "vllm/*"],
      },
    },
  },
}

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-sonnet-4-6" },
      modelPolicy: {
        allow: ["anthropic/claude-sonnet-4-6", "anthropic/claude-opus-4-6"],
      },
      models: {
        "anthropic/claude-sonnet-4-6": { alias: "Sonnet" },
        "anthropic/claude-opus-4-6": { alias: "Opus" },
      },
    },
  },
}

openclaw config set agents.defaults.modelPolicy.allow '["openai/gpt-5.4","anthropic/*"]' --strict-json

​

チャットでの /model

/model
/model list
/model 3
/model openai/gpt-5.4
/model default
/model status

• /model と /model list は、コンパクトな番号付きピッカー（モデルファミリー + 利用可能なプロバイダー）を表示し、/model <#> はそこから選択します。Discord では、Submit ステップを伴うプロバイダー／モデルのドロップダウンが開きます。Telegram では、ピッカーでの選択はセッションスコープであり、openclaw.json にあるエージェントの永続的なデフォルトを書き換えることはありません。/models add は非推奨であり、チャットからモデルを登録する代わりにメッセージを返します。
• /model は、新しいセッション選択を即座に永続化します。エージェントがアイドル状態の場合、次の実行ですぐに使用されます。実行がすでにアクティブな場合、切り替えは次のクリーンな再試行ポイント（ツールの動作または応答出力がすでに開始されている場合は、それ以降のポイント）までキューに入れられます。
• /model default はセッション選択をクリアし、設定済みのプライマリを再び継承するようにします。
• ユーザーが選択した /model 参照は、そのセッションでは厳格に適用されます。到達不能になった場合、agents.defaults.model.fallbacks を通じて暗黙的にフォールバックするのではなく、応答が明示的に失敗します。設定済みのデフォルトと cron ジョブのプライマリでは、引き続きフォールバックチェーンが使用されます。
• /model status は詳細ビューです。プロバイダーごとの認証候補に加え、設定されている場合はプロバイダーエンドポイント baseUrl と api モードが表示されます。
• モデル参照は、最初の / で分割して解析されます。provider/model と入力してください。モデル ID 自体に / が含まれる場合（OpenRouter 形式）は、プロバイダーのプレフィックスを含めます（例: /model openrouter/moonshotai/kimi-k2）。プロバイダーを省略すると、OpenClaw は（1）エイリアスの一致、（2）そのプレフィックスなしの正確なモデル ID に対する一意の設定済みプロバイダーの一致、（3）設定済みのデフォルトプロバイダー（非推奨のフォールバック）の順で試行します。そのプロバイダーが設定済みのデフォルトモデルを提供しなくなっている場合は、削除済みプロバイダーの古いデフォルトが表面化するのを避けるため、代わりに最初の設定済みプロバイダー／モデルを使用します。
• モデル参照は小文字に正規化されます。それ以外ではプロバイダー ID は厳密に扱われるため、Plugin が提示する ID を使用してください。

​

CLI

openclaw models status
openclaw models list
openclaw models set <provider/model>
openclaw models set-image <provider/model>
openclaw models scan
openclaw models aliases list|add|remove
openclaw models fallbacks list|add|remove|clear
openclaw models image-fallbacks list|add|remove|clear
openclaw models auth list|add|login|paste-api-key|paste-token|setup-token|order

​

モデルレジストリ（models.json）

​

関連項目

• エージェントランタイム — OpenClaw、Codex、およびその他のエージェントループランタイム
• 設定リファレンス — モデル設定キー
• 画像生成 — 画像モデルの設定
• モデルフェイルオーバー — フォールバックチェーン
• モデルプロバイダー — プロバイダーのルーティングと認証
• Models CLI リファレンス — コマンドとフラグの完全なリファレンス
• 音楽生成 — 音楽モデルの設定
• 動画生成 — 動画モデルの設定