OpenClawのモデル設定ガイド：最適なAIモデルを使い分ける方法

Model Selection & Aliases

開発を進めていると、用途に合わせてモデルを使い分けたい場面がよくありますよね。でも、そのたびに設定ファイルを書き換えたり、複雑なコマンドを覚えたりするのは面倒なものです。OpenClawなら、モデルの選択や切り替えを驚くほどスムーズに行えます。

プロジェクトの性質や予算に合わせて、最適なモデルを賢く選ぶための方法を見ていきましょう。

---

「デフォルトモデル」とは何ですか？

OpenClawのデフォルトモデルは、以下の設定項目で指定されたモデルを指します。

agents.defaults.model.primary

モデルは provider/model という形式で参照されます（例：anthropic/claude-opus-4-5）。

---

どのモデルがおすすめですか？

OpenClawを最大限に活かすための、私のおすすめ構成はこちらです。

• 推奨デフォルト: anthropic/claude-opus-4-5
• 優れた代替案: anthropic/claude-sonnet-4-5
• 安定性重視（個性は控えめ）: openai/gpt-5.2
• コスト重視: zai/glm-4.7

基本的には、予算が許す限り最高のモデルを重要な仕事に使い、日常的なチャットや要約には安価なモデルを使うのが賢いやり方です。

⚠️ 重要な警告: 性能が低いモデルや、過度に量子化されたモデルは、プロンプトインジェクションや予期しない挙動に対して脆弱です。

---

セルフホストしたモデル（llama.cpp, vLLM, Ollama）は使えますか？

はい、使えます。ローカルサーバーが OpenAI 互換の API を提供していれば、カスタムプロバイダーとして指定可能です。特に Ollama は直接サポートされているので、一番簡単に導入できます。

セキュリティに関する注意: 小規模なモデルや重度に量子化されたモデルは、プロンプトインジェクションに対して脆弱です。ツールを使用するボットを運用する場合は、大規模なモデルを使用することを強くおすすめします。

---

設定を消さずにモデルを切り替えるには？

設定全体を壊さずにモデルだけを変更するには、以下の安全な方法があります。

• チャット内で /model を使用（そのセッション限りのクイックな変更）
• openclaw models set ... を実行（モデル設定のみを更新）
• openclaw configure --section models を実行（対話形式で設定）
• ~/.openclaw/openclaw.json 内の agents.defaults.model を直接編集

設定全体を置き換えてしまう可能性があるため、意図しない限り config.apply で部分的なオブジェクトを適用するのは避けましょう。

---

再起動せずにその場でモデルを切り替えるには？

チャット中に /model コマンドをメッセージとして送信してください。

/model sonnet
/model haiku
/model opus
/model gpt
/model gpt-mini
/model gemini
/model gemini-flash

利用可能なモデルの一覧は、/model、/model list、または /model status で確認できます。

番号で選択することも可能です。

/model 3

特定の認証プロファイルを強制的に指定することもできます。

/model opus@anthropic:default
/model opus@anthropic:work

---

日常的なタスクには GPT 5.2、コーディングには Codex 5.2 を使い分けることはできますか？

はい、もちろんです。

方法 A: セッションごとに切り替える 片方をデフォルトに設定しておき、必要に応じて切り替えます。

/model gpt-5.2      # for daily tasks
/model gpt-5.2-codex  # for coding

方法 B: サブエージェントを使う コーディングタスクを、別のデフォルトモデルが設定されたサブエージェントにルーティングします。

---

「Model … is not allowed」と表示されて返信が来ないのはなぜですか？

agents.defaults.models が設定されている場合、それが /model コマンドやセッションの上書きに対する**許可リスト（allowlist）**として機能します。そのリストに含まれていないモデルを選択するとエラーになります。

解決策: そのモデルを agents.defaults.models に追加するか、許可リスト自体を削除するか、/model list に表示されるモデルから選択してください。

---

「Unknown model: minimax/MiniMax-M2.1」と表示されるのはなぜですか？

これは、プロバイダーが設定されていないことを意味します（MiniMax のプロバイダー設定や認証プロファイルが見つかりません）。

チェックリスト:

1. MiniMax が設定されているか確認（ウィザードまたは JSON）
2. 正確なモデル ID を使用しているか確認（大文字小文字を区別）：minimax/MiniMax-M2.1
3. openclaw models list を実行し、リストから選択する

---

opus / sonnet / gpt は組み込みのショートカットですか？

はい。OpenClaw には、デフォルトでいくつかのショートカット（エイリアス）が用意されています。

• opus → anthropic/claude-opus-4-5
• sonnet → anthropic/claude-sonnet-4-5
• gpt → openai/gpt-5.2
• gpt-mini → openai/gpt-5-mini
• gemini → google/gemini-3-pro-preview
• gemini-flash → google/gemini-3-flash-preview

自分で同じ名前のエイリアスを定義した場合は、そちらの設定が優先されます。

---

モデルのショートカット（エイリアス）を定義・上書きするには？

エイリアスは agents.defaults.models.<modelId>.alias で定義します。

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-opus-4-5" },
      models: {
        "anthropic/claude-opus-4-5": { alias: "opus" },
        "anthropic/claude-sonnet-4-5": { alias: "sonnet" },
        "anthropic/claude-haiku-4-5": { alias: "haiku" }
      }
    }
  }
}

---

OpenRouter や Z.AI のような他のプロバイダーのモデルを追加するには？

それぞれの API キーを環境変数に設定し、モデルを指定します。

OpenRouter の場合:

{
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
      models: { "openrouter/anthropic/claude-sonnet-4-5": {} }
    }
  },
  env: { OPENROUTER_API_KEY: "sk-or-..." }
}

Z.AI の場合:

{
  agents: {
    defaults: {
      model: { primary: "zai/glm-4.7" },
      models: { "zai/glm-4.7": {} }
    }
  },
  env: { ZAI_API_KEY: "..." }
}

---

次のステップ

• プロバイダーの設定方法を学ぶ
• サブエージェントでタスクを分散する

セットアップで困ったときは、AI Setup Assistant にいつでも相談してくださいね。