Models CLI

​

選択順序

• agents.defaults.models は、OpenClaw が使用できるモデルの許可リスト/カタログとエイリアスです。各モデルを列挙せずに、プロバイダーから検出されたすべてのモデルを許可するには provider/* エントリを使用します。
• agents.defaults.utilityModel は、生成されるダッシュボードセッションタイトルや、対応チャンネルのスレッド/トピックタイトルなど、短い内部タスク用の任意の低コストモデルです。エージェントごとの agents.list[].utilityModel はこれを上書きします。未設定の場合、これらのタスクはエージェントのプライマリモデルを使用します。ユーティリティタスクは個別のモデル呼び出しであり、選択されたモデルプロバイダーに限定されたタスク内容を送信する場合があります。
• agents.defaults.imageModel は、プライマリモデルが画像を受け付けられない場合にのみ使用されます。
• agents.defaults.pdfModel は pdf ツールで使用されます。未設定の場合、ツールは imageModel、次に解決済みのセッション/デフォルトモデルへフォールバックします。
• agents.defaults.imageGenerationModel、musicGenerationModel、videoGenerationModel は共有メディア生成ツールを支えます。未設定の場合、各ツールは認証に裏付けられたプロバイダーデフォルトを推論します。現在のデフォルトプロバイダーを最初に使い、次にその機能に登録されている残りのプロバイダーをプロバイダー ID 順に使います。明示的なフォールバックを維持しつつ、そのプロバイダー横断の推論を無効化するには agents.defaults.mediaGenerationAutoProviderFallback: false を設定します。
• エージェントごとの agents.list[].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 に問い合わせます。agents.defaults.models が設定されている場合はそれ ( provider/* ワイルドカードエントリを含む) を使用し、そうでない場合は models.providers.*.models と利用可能な認証を持つプロバイダーを使用します。完全な組み込みカタログは、明示的な参照ビュー (view: "all" の models.list、または openclaw models list --all) 用に予約されています。

​

簡易モデルポリシー

• プライマリは、利用可能な最も強力な最新世代モデルに設定します。
• コスト/レイテンシーに敏感なタスクや低リスクのチャットにはフォールバックを使用します。
• ツール有効のエージェントや信頼できない入力では、古い/弱いモデル階層を避けます。

​

オンボーディング

openclaw onboard

​

「Model is not allowed」(および返信が止まる理由)

Model "provider/model" is not allowed. Use /models to list providers, or /models <provider> to list models.
Add it with: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge

{
  agents: {
    defaults: {
      models: {
        "openai/*": {},
        "vllm/*": {},
      },
    },
  },
}

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

openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --merge

​

チャット内の /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 リファレンス — 完全なコマンドとフラグのリファレンス
• 音楽生成 — 音楽モデル設定
• 動画生成 — 動画モデル設定