モデル CLI

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

モデル選択の仕組み

​

選択元とフォールバック動作

• 設定済みデフォルト（agents.defaults.model.primary とエージェント固有のプライマリ）は通常の開始点であり、agents.defaults.model.fallbacks を使用します。
• 自動フォールバック選択は一時的な復旧状態です。modelOverrideSource: "auto" として保存されるため、以降のターンでは既知の不良プライマリを先にプローブせずにフォールバックチェーンを使い続けられます。
• ユーザーセッション選択は厳密です。/model、モデルピッカー、session_status(model=...)、sessions.patch は modelOverrideSource: "user" を保存します。その選択されたプロバイダー/モデルに到達できない場合、OpenClaw は別の設定済みモデルへフォールスルーせず、目に見える形で失敗します。
• Cron --model / ペイロード model はジョブごとのプライマリです。ジョブが明示的なペイロード fallbacks を指定しない限り、設定済みフォールバックを引き続き使用します（厳密な cron 実行には fallbacks: [] を使用します）。
• 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

​

設定キー（概要）

• agents.defaults.model.primary と agents.defaults.model.fallbacks
• agents.defaults.imageModel.primary と agents.defaults.imageModel.fallbacks
• agents.defaults.pdfModel.primary と agents.defaults.pdfModel.fallbacks
• agents.defaults.imageGenerationModel.primary と agents.defaults.imageGenerationModel.fallbacks
• agents.defaults.videoGenerationModel.primary と agents.defaults.videoGenerationModel.fallbacks
• agents.defaults.models（許可リスト + エイリアス + プロバイダーパラメーター + provider/* 動的プロバイダーエントリ）
• models.providers（models.json に書き込まれるカスタムプロバイダー）

​

安全な許可リスト編集

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

​

「モデルは許可されていません」（そして返信が止まる理由）

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-codex/*": {},
        "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" },
      },
    },
  },
}

​

チャットでモデルを切り替える（/model）

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

​

CLI コマンド

openclaw models list
openclaw models status
openclaw models set <provider/model>
openclaw models set-image <provider/model>

openclaw models aliases list
openclaw models aliases add <alias> <provider/model>
openclaw models aliases remove <alias>

openclaw models fallbacks list
openclaw models fallbacks add <provider/model>
openclaw models fallbacks remove <provider/model>
openclaw models fallbacks clear

openclaw models image-fallbacks list
openclaw models image-fallbacks add <provider/model>
openclaw models image-fallbacks remove <provider/model>
openclaw models image-fallbacks clear

​

models list

​

models status

claude auth login
openclaw models status

​

スキャン（OpenRouter 無料モデル）

1. 画像サポート
2. ツールのレイテンシ
3. コンテキストサイズ
4. パラメーター数

• OpenRouter /models リスト（フィルター :free）
• ライブプローブには、認証プロファイルまたは OPENROUTER_API_KEY からの OpenRouter API キーが必要です（環境変数を参照）
• 任意のフィルター: --max-age-days、--min-params、--provider、--max-candidates
• リクエスト/プローブ制御: --timeout、--concurrency

​

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

​

関連

• エージェントランタイム — PI、Codex、その他のエージェントループランタイム
• 設定リファレンス — モデル設定キー
• 画像生成 — 画像モデル設定
• モデルフェイルオーバー — フォールバックチェーン
• モデルプロバイダー — プロバイダールーティングと認証
• 音楽生成 — 音楽モデル設定
• 動画生成 — 動画モデル設定