モデルプロバイダー

LLM/モデルプロバイダー（WhatsApp/Telegram のようなチャットチャンネルではない）のリファレンスです。モデル選択ルールについては、モデルを参照してください。

基本ルール

Plugin 所有のプロバイダー動作

プロバイダー固有ロジックの大半はプロバイダーPlugin（registerProvider(...)）にあり、OpenClaw は汎用推論ループを保持します。Plugin は、オンボーディング、モデルカタログ、認証環境変数のマッピング、トランスポート/設定の正規化、ツールスキーマのクリーンアップ、フェイルオーバー分類、OAuth 更新、使用量レポート、思考/推論プロファイルなどを所有します。

プロバイダー SDK フックとバンドルPlugin例の完全な一覧は、プロバイダーPluginにあります。完全にカスタムのリクエスト実行機構を必要とするプロバイダーは、別のより深い拡張サーフェスです。

API キーローテーション

組み込みプロバイダー（pi-ai カタログ）

OpenClaw には pi-ai カタログが同梱されています。これらのプロバイダーには models.providers 設定は不要 です。認証を設定してモデルを選択するだけです。

OpenAI

• プロバイダー: openai
• 認証: OPENAI_API_KEY
• 任意のローテーション: OPENAI_API_KEYS、OPENAI_API_KEY_1、OPENAI_API_KEY_2、さらに OPENCLAW_LIVE_OPENAI_KEY（単一上書き）
• モデル例: openai/gpt-5.5、openai/gpt-5.4-mini
• 特定のインストールまたは API キーの動作が異なる場合は、openclaw models list --provider openai でアカウント/モデルの利用可否を確認してください。
• CLI: openclaw onboard --auth-choice openai-api-key
• デフォルトトランスポートは auto です。OpenClaw はトランスポート選択を pi-ai に渡します。
• モデルごとに agents.defaults.models["openai/<model>"].params.transport（"sse"、"websocket"、または "auto"）で上書きします。
• OpenAI 優先処理は agents.defaults.models["openai/<model>"].params.serviceTier で有効化できます。
• /fast と params.fastMode は、直接の openai/* Responses リクエストを api.openai.com 上の service_tier=priority にマッピングします。
• 共有の /fast トグルではなく明示的なティアを指定したい場合は params.serviceTier を使用します。
• 隠し OpenClaw 帰属ヘッダー（originator、version、User-Agent）は、api.openai.com へのネイティブ OpenAI トラフィックにのみ適用され、汎用 OpenAI 互換プロキシには適用されません。
• ネイティブ OpenAI ルートは、Responses の store、プロンプトキャッシュヒント、OpenAI 推論互換のペイロード整形も保持します。プロキシルートは保持しません。
• openai/gpt-5.3-codex-spark は、ライブ OpenAI API リクエストが拒否し、現在の Codex カタログでも公開されていないため、OpenClaw では意図的に抑制されています。

{  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },}

Anthropic

• プロバイダー: anthropic
• 認証: ANTHROPIC_API_KEY
• 任意のローテーション: ANTHROPIC_API_KEYS、ANTHROPIC_API_KEY_1、ANTHROPIC_API_KEY_2、さらに OPENCLAW_LIVE_ANTHROPIC_KEY（単一上書き）
• モデル例: anthropic/claude-opus-4-6
• CLI: openclaw onboard --auth-choice apiKey
• 直接の公開 Anthropic リクエストは、api.anthropic.com に送信される API キーおよび OAuth 認証済みトラフィックを含め、共有の /fast トグルと params.fastMode をサポートします。OpenClaw はそれを Anthropic の service_tier（auto 対 standard_only）にマッピングします。
• 推奨 Claude CLI 設定では、モデル参照を正規のままにし、CLI バックエンドを別に選択します: anthropic/claude-opus-4-7 と モデルスコープの agentRuntime.id: "claude-cli"。レガシーの claude-cli/claude-opus-4-7 参照も互換性のため引き続き動作します。

{  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },}

OpenAI Codex OAuth

• プロバイダー: openai-codex
• 認証: OAuth（ChatGPT）
• レガシー PI モデル参照: openai-codex/gpt-5.5
• ネイティブ Codex アプリサーバーハーネス参照: openai/gpt-5.5
• ネイティブ Codex アプリサーバーハーネスドキュメント: Codex ハーネス
• レガシーモデル参照: codex/gpt-*
• Plugin 境界: openai-codex/* は OpenAI Plugin を読み込みます。ネイティブ Codex アプリサーバーPluginは、Codex ハーネスランタイムまたはレガシー codex/* 参照によってのみ選択されます。
• CLI: openclaw onboard --auth-choice openai-codex または openclaw models auth login --provider openai-codex
• デフォルトトランスポートは auto（WebSocket 優先、SSE フォールバック）
• PI モデルごとに agents.defaults.models["openai-codex/<model>"].params.transport（"sse"、"websocket"、または "auto"）で上書きします。
• params.serviceTier はネイティブ Codex Responses リクエスト（chatgpt.com/backend-api）でも転送されます。
• 隠し OpenClaw 帰属ヘッダー（originator、version、User-Agent）は、chatgpt.com/backend-api へのネイティブ Codex トラフィックにのみ付与され、汎用 OpenAI 互換プロキシには付与されません。
• 直接の openai/* と同じ /fast トグルおよび params.fastMode 設定を共有します。OpenClaw はそれを service_tier=priority にマッピングします。
• openai-codex/gpt-5.5 は、Codex カタログネイティブの contextWindow = 400000 とデフォルトランタイムの contextTokens = 272000 を使用します。ランタイム上限は models.providers.openai-codex.models[].contextTokens で上書きします。
• ポリシーノート: OpenAI Codex OAuth は、OpenClaw のような外部ツール/ワークフローで明示的にサポートされています。
• 一般的なサブスクリプションとネイティブ Codex ランタイムのルートでは、openai-codex 認証でサインインし、openai/gpt-5.5 を設定します。OpenAI エージェントターンはデフォルトで Codex を選択します。
• PI 経由の互換ルートが必要な場合にのみ、プロバイダー/モデルの agentRuntime.id: "pi" を使用します。それ以外の場合は、openai/gpt-5.5 をデフォルトの Codex ハーネスのままにします。
• 以前の openai-codex/gpt-5.1*、openai-codex/gpt-5.2*、openai-codex/gpt-5.3* 参照は、ChatGPT/Codex OAuth アカウントが拒否するため抑制されています。代わりに openai-codex/gpt-5.5 またはネイティブ Codex ランタイムルートを使用してください。

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },}

{  models: {    providers: {      "openai-codex": {        models: [{ id: "gpt-5.5", contextTokens: 160000 }],      },    },  },}

その他のサブスクリプション型ホストオプション

OpenCode

• 認証: OPENCODE_API_KEY（または OPENCODE_ZEN_API_KEY）
• Zen ランタイムプロバイダー: opencode
• Go ランタイムプロバイダー: opencode-go
• モデル例: opencode/claude-opus-4-6、opencode-go/kimi-k2.6
• CLI: openclaw onboard --auth-choice opencode-zen または openclaw onboard --auth-choice opencode-go

{  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },}

Google Gemini（API キー）

• プロバイダー: google
• 認証: GEMINI_API_KEY
• オプションのローテーション: GEMINI_API_KEYS、GEMINI_API_KEY_1、GEMINI_API_KEY_2、GOOGLE_API_KEY フォールバック、および OPENCLAW_LIVE_GEMINI_KEY（単一の上書き）
• モデル例: google/gemini-3.1-pro-preview、google/gemini-3-flash-preview
• 互換性: google/gemini-3.1-flash-preview を使用する従来の OpenClaw 設定は google/gemini-3-flash-preview に正規化されます
• エイリアス: google/gemini-3.1-pro は受け入れられ、Google のライブ Gemini API ID である google/gemini-3.1-pro-preview に正規化されます
• CLI: openclaw onboard --auth-choice gemini-api-key
• 思考: /think adaptive は Google の動的思考を使用します。Gemini 3/3.1 は固定の thinkingLevel を省略します。Gemini 2.5 は thinkingBudget: -1 を送信します。
• Gemini の直接実行では、プロバイダー固有の cachedContents/... ハンドルを転送するために agents.defaults.models["google/<model>"].params.cachedContent（または従来の cached_content）も受け入れます。Gemini キャッシュヒットは OpenClaw の cacheRead として表示されます

Google Vertex と Gemini CLI

• プロバイダー: google-vertex、google-gemini-cli
• 認証: Vertex は gcloud ADC を使用します。Gemini CLI は独自の OAuth フローを使用します

Gemini CLI OAuth はバンドルされた google Plugin の一部として提供されます。

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

openclaw models auth login --provider google-gemini-cli --set-default

Gemini CLI の JSON 応答は response から解析されます。使用量は stats にフォールバックし、stats.cached は OpenClaw の cacheRead に正規化されます。

Z.AI (GLM)

• プロバイダー: zai
• 認証: ZAI_API_KEY
• モデル例: zai/glm-5.1
• CLI: openclaw onboard --auth-choice zai-api-key
  • エイリアス: z.ai/* と z-ai/* は zai/* に正規化されます
  • zai-api-key は一致する Z.AI エンドポイントを自動検出します。zai-coding-global、zai-coding-cn、zai-global、zai-cn は特定のサーフェスを強制します

Vercel AI Gateway

• プロバイダー: vercel-ai-gateway
• 認証: AI_GATEWAY_API_KEY
• モデル例: vercel-ai-gateway/anthropic/claude-opus-4.6、vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI: openclaw onboard --auth-choice ai-gateway-api-key

Kilo Gateway

• プロバイダー: kilocode
• 認証: KILOCODE_API_KEY
• モデル例: kilocode/kilo/auto
• CLI: openclaw onboard --auth-choice kilocode-api-key
• ベース URL: https://api.kilo.ai/api/gateway/
• 静的フォールバックカタログには kilocode/kilo/auto が含まれます。ライブの https://api.kilo.ai/api/gateway/models 検出により、ランタイムカタログをさらに拡張できます。
• kilocode/kilo/auto の背後にある正確なアップストリームルーティングは Kilo Gateway が所有しており、OpenClaw にハードコードされていません。

セットアップの詳細は /providers/kilocode を参照してください。

その他のバンドル済みプロバイダー Plugin

知っておくべき癖

models.providers 経由のプロバイダー（カスタム/ベース URL）

models.providers（または models.json）を使って、カスタムプロバイダーや OpenAI/Anthropic 互換プロキシを追加します。

以下の同梱プロバイダー Plugin の多くは、すでにデフォルトカタログを公開しています。デフォルトのベース URL、ヘッダー、モデル一覧を上書きしたい場合にのみ、明示的な models.providers.<id> エントリを使ってください。

Gateway のモデル機能チェックは、明示的な models.providers.<id>.models[] メタデータも読み取ります。カスタムモデルまたはプロキシモデルが画像を受け付ける場合は、そのモデルに input: ["text", "image"] を設定し、WebChat とノード由来の添付ファイルパスが、テキスト専用メディア参照ではなくネイティブモデル入力として画像を渡せるようにします。

agents.defaults.models["provider/model"] は、エージェント向けのモデル表示、エイリアス、モデルごとのメタデータだけを制御します。それ自体では新しいランタイムモデルを登録しません。カスタムプロバイダーモデルでは、少なくとも一致する id を含む models.providers.<provider>.models[] も追加してください。

Moonshot AI (Kimi)

Moonshot は同梱プロバイダー Plugin として提供されます。デフォルトでは組み込みプロバイダーを使い、ベース URL またはモデルメタデータを上書きする必要がある場合にのみ、明示的な models.providers.moonshot エントリを追加します。

• プロバイダー: moonshot
• 認証: MOONSHOT_API_KEY
• モデル例: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key または openclaw onboard --auth-choice moonshot-api-key-cn

Kimi K2 モデル ID:

• moonshot/kimi-k2.6
• moonshot/kimi-k2.5
• moonshot/kimi-k2-thinking
• moonshot/kimi-k2-thinking-turbo
• moonshot/kimi-k2-turbo

{  agents: {    defaults: { model: { primary: "moonshot/kimi-k2.6" } },  },  models: {    mode: "merge",    providers: {      moonshot: {        baseUrl: "https://api.moonshot.ai/v1",        apiKey: "${MOONSHOT_API_KEY}",        api: "openai-completions",        models: [{ id: "kimi-k2.6", name: "Kimi K2.6" }],      },    },  },}

Kimi coding

Kimi Coding は Moonshot AI の Anthropic 互換エンドポイントを使用します。

• プロバイダー: kimi
• 認証: KIMI_API_KEY
• モデル例: kimi/kimi-for-coding

{  env: { KIMI_API_KEY: "sk-..." },  agents: {    defaults: { model: { primary: "kimi/kimi-for-coding" } },  },}

従来の kimi/kimi-code と kimi/k2p5 は互換モデル ID として引き続き受け入れられ、Kimi の安定版 API モデル ID に正規化されます。

Volcano Engine (Doubao)

Volcano Engine (火山引擎) は、中国で Doubao やその他のモデルへのアクセスを提供します。

• プロバイダー: volcengine (コーディング: volcengine-plan)
• 認証: VOLCANO_ENGINE_API_KEY
• モデル例: volcengine-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice volcengine-api-key

{  agents: {    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },  },}

オンボーディングではデフォルトでコーディングサーフェスが使用されますが、汎用の volcengine/* カタログも同時に登録されます。

オンボーディング/設定のモデルピッカーでは、Volcengine の認証選択は volcengine/* と volcengine-plan/* の両方の行を優先します。これらのモデルがまだ読み込まれていない場合、OpenClaw は空のプロバイダースコープのピッカーを表示する代わりに、フィルターなしのカタログにフォールバックします。

BytePlus (国際)

BytePlus ARK は、国際ユーザー向けに Volcano Engine と同じモデルへのアクセスを提供します。

• プロバイダー: byteplus (コーディング: byteplus-plan)
• 認証: BYTEPLUS_API_KEY
• モデル例: byteplus-plan/ark-code-latest
• CLI: openclaw onboard --auth-choice byteplus-api-key

{  agents: {    defaults: { model: { primary: "byteplus-plan/ark-code-latest" } },  },}

オンボーディングではデフォルトでコーディングサーフェスが使用されますが、汎用の byteplus/* カタログも同時に登録されます。

オンボーディング/設定のモデルピッカーでは、BytePlus の認証選択は byteplus/* と byteplus-plan/* の両方の行を優先します。これらのモデルがまだ読み込まれていない場合、OpenClaw は空のプロバイダースコープのピッカーを表示する代わりに、フィルターなしのカタログにフォールバックします。

Synthetic

Synthetic は synthetic プロバイダーの背後で Anthropic 互換モデルを提供します。

• プロバイダー: synthetic
• 認証: SYNTHETIC_API_KEY
• モデル例: synthetic/hf:MiniMaxAI/MiniMax-M2.5
• CLI: openclaw onboard --auth-choice synthetic-api-key

{  agents: {    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } },  },  models: {    mode: "merge",    providers: {      synthetic: {        baseUrl: "https://api.synthetic.new/anthropic",        apiKey: "${SYNTHETIC_API_KEY}",        api: "anthropic-messages",        models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }],      },    },  },}

MiniMax

MiniMax はカスタムエンドポイントを使用するため、models.providers 経由で設定します。

• MiniMax OAuth (グローバル): --auth-choice minimax-global-oauth
• MiniMax OAuth (中国): --auth-choice minimax-cn-oauth
• MiniMax API キー (グローバル): --auth-choice minimax-global-api
• MiniMax API キー (中国): --auth-choice minimax-cn-api
• 認証: minimax には MINIMAX_API_KEY; minimax-portal には MINIMAX_OAUTH_TOKEN または MINIMAX_API_KEY

セットアップの詳細、モデルオプション、設定スニペットについては /providers/minimax を参照してください。

Plugin が所有する機能分割:

• テキスト/チャットのデフォルトは minimax/MiniMax-M2.7 のままです
• 画像生成は minimax/image-01 または minimax-portal/image-01 です
• 画像理解は、両方の MiniMax 認証パスで Plugin 所有の MiniMax-VL-01 です
• Web 検索はプロバイダー ID minimax のままです

LM Studio

LM Studio は、ネイティブ API を使用するバンドル済みプロバイダー Plugin として提供されます。

• プロバイダー: lmstudio
• 認証: LM_API_TOKEN
• デフォルトの推論ベース URL: http://localhost:1234/v1

次にモデルを設定します (http://localhost:1234/api/v1/models が返す ID のいずれかに置き換えてください)。

{  agents: {    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },  },}

OpenClaw は検出と自動読み込みに LM Studio のネイティブ /api/v1/models と /api/v1/models/load を使用し、デフォルトでは推論に /v1/chat/completions を使用します。LM Studio の JIT 読み込み、TTL、自動退避にモデルライフサイクルを所有させたい場合は、models.providers.lmstudio.params.preload: false を設定します。セットアップとトラブルシューティングについては /providers/lmstudio を参照してください。

Ollama

Ollama はバンドル済みプロバイダー Plugin として提供され、Ollama のネイティブ API を使用します。

• プロバイダー: ollama
• 認証: 不要 (ローカルサーバー)
• モデル例: ollama/llama3.3
• インストール: https://ollama.com/download

# Install Ollama, then pull a model:ollama pull llama3.3

{  agents: {    defaults: { model: { primary: "ollama/llama3.3" } },  },}

Ollama は OLLAMA_API_KEY でオプトインすると http://127.0.0.1:11434 でローカル検出され、バンドル済みプロバイダー Plugin が Ollama を openclaw onboard とモデルピッカーに直接追加します。オンボーディング、クラウド/ローカルモード、カスタム設定については /providers/ollama を参照してください。

vLLM

vLLM は、ローカル/セルフホストの OpenAI 互換サーバー向けのバンドル済みプロバイダー Plugin として提供されます。

• プロバイダー: vllm
• 認証: 任意 (サーバーによって異なります)
• デフォルトのベース URL: http://127.0.0.1:8000/v1

ローカルで自動検出にオプトインするには (サーバーが認証を強制しない場合は任意の値で機能します)。

export VLLM_API_KEY="vllm-local"

次にモデルを設定します (/v1/models が返す ID のいずれかに置き換えてください)。

{  agents: {    defaults: { model: { primary: "vllm/your-model-id" } },  },}

詳細については /providers/vllm を参照してください。

SGLang

SGLang は、高速なセルフホストの OpenAI 互換サーバー向けのバンドル済みプロバイダー Plugin として提供されます。

• プロバイダー: sglang
• 認証: 任意 (サーバーによって異なります)
• デフォルトのベース URL: http://127.0.0.1:30000/v1

ローカルで自動検出にオプトインするには (サーバーが認証を強制しない場合は任意の値で機能します)。

export SGLANG_API_KEY="sglang-local"

次にモデルを設定します (/v1/models が返す ID のいずれかに置き換えてください)。

{  agents: {    defaults: { model: { primary: "sglang/your-model-id" } },  },}

詳細については /providers/sglang を参照してください。

ローカルプロキシ (LM Studio、vLLM、LiteLLM など)

例 (OpenAI 互換):

{  agents: {    defaults: {      model: { primary: "lmstudio/my-local-model" },      models: { "lmstudio/my-local-model": { alias: "Local" } },    },  },  models: {    providers: {      lmstudio: {        baseUrl: "http://localhost:1234/v1",        apiKey: "${LM_API_TOKEN}",        api: "openai-completions",        timeoutSeconds: 300,        models: [          {            id: "my-local-model",            name: "Local Model",            reasoning: false,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 200000,            maxTokens: 8192,          },        ],      },    },  },}

CLI の例

openclaw onboard --auth-choice opencode-zenopenclaw models set opencode/claude-opus-4-6openclaw models list

完全な設定例については、設定 も参照してください。

関連

• 設定リファレンス - モデル設定キー
• モデルフェイルオーバー - フォールバックチェーンと再試行動作
• モデル - モデル設定とエイリアス
• プロバイダー - プロバイダーごとのセットアップガイド