モデル CLI

​

モデル選択の仕組み

1. メインモデル (agents.defaults.model.primary または agents.defaults.model)。
2. agents.defaults.model.fallbacks に指定された フォールバックモデル (記述順)。
3. 次のモデルへ移行する前に、現在のプロバイダー内で 認証プロファイルの切り替え を試みます。

• agents.defaults.models は、OpenClaw が使用できるモデルの許可リスト（カタログ）およびエイリアスの定義です。
• agents.defaults.imageModel は、メインモデルが画像入力を受け付けない場合に のみ 使用されます。
• agents.list[].model を設定することで、エージェントごとにデフォルト設定を上書きできます（マルチエージェント を参照）。

​

モデル運用の指針

• メインモデルには、現在利用可能な最新世代の最も強力なモデルを設定してください。
• フォールバックモデルは、コストや遅延を抑えたいタスクや、重要度の低いチャット用に使用します。
• ツールを使用するエージェントや、信頼できない入力を扱う場合は、古いモデルや能力の低いモデルの使用を避けてください。

​

セットアップウィザード (推奨)

openclaw onboard

​

設定項目 (概要)

• agents.defaults.model.primary および agents.defaults.model.fallbacks
• agents.defaults.imageModel.primary および agents.defaults.imageModel.fallbacks
• agents.defaults.models (許可リスト + エイリアス + プロバイダー用パラメータ)
• models.providers (models.json に書き込まれるカスタムプロバイダー設定)

​

「Model is not allowed」エラーについて

Model "provider/model" is not allowed. Use /model to list available models.

• そのモデルを agents.defaults.models に追加する。
• 許可リストをクリア（agents.defaults.models を削除）する。
• /model list で表示されるモデルから選択する。

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

​

チャット内でのモデル切り替え (/model)

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

• /model (および /model list) は、モデルファミリーと利用可能なプロバイダーを番号付きで表示するコンパクトなピッカーです。
• Discord では、プロバイダーとモデルを選択して送信する、インタラクティブな選択メニューが開きます。
• /model <番号> で、そのピッカーからモデルを選択できます。
• /model status では、詳細な情報（認証の候補、構成済みの場合はプロバイダーの baseUrl や API モード）を表示します。
• モデルの指定は、最初に出現する / で分割して解析されます。/model <ref> と入力する際は provider/model の形式にしてください。
• モデル ID 自体に / が含まれる場合（OpenRouter 形式など）は、プロバイダーのプレフィックスを含める必要があります（例: /model openrouter/moonshotai/kimi-k2）。
• プロバイダーを省略した場合、OpenClaw は入力をエイリアス、あるいは デフォルトプロバイダー のモデルとして扱います（モデル ID 内に / が含まれない場合にのみ機能します）。

​

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

• --all: すべてのカタログを表示
• --local: ローカルプロバイダーのみを表示
• --provider <name>: 指定したプロバイダーでフィルタリング
• --plain: 1 行に 1 モデルの形式で出力
• --json: 機械可読な JSON 形式で出力

​

models status

claude setup-token
openclaw models status

​

モデルスキャン (OpenRouter 無料モデル)

• --no-probe: 実際の調査を行わずメタデータのみを取得
• --min-params <b>: 最小パラメータ数（10億単位）でフィルタリング
• --max-age-days <days>: 更新が古いモデルを除外
• --provider <name>: プロバイダー名のプレフィックスでフィルタリング
• --max-candidates <n>: フォールバックリストに含める最大数
• --set-default: 最初の候補を agents.defaults.model.primary に設定
• --set-image: 最初の画像対応候補を agents.defaults.imageModel.primary に設定

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

​

モデルレジストリ (models.json)

• エージェントディレクトリの models.json に既にある空でない baseUrl が最優先されます。
• apiKey は、そのプロバイダーが SecretRef で管理されていない場合にのみ、エージェントディレクトリの models.json の値が優先されます。
• SecretRef 管理下のプロバイダーの apiKey は、解決後のシークレットではなく、ソースマーカー（環境変数参照なら変数名、その他なら secretref-managed）として保存されます。
• 他のフィールドは構成ファイルや正規化されたカタログデータから更新されます。