モデルプロバイダー

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

クイックルール

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

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

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

API キーのローテーション

公式プロバイダー Plugin

公式プロバイダー Plugin は独自のモデルカタログ行を公開します。これらのプロバイダーには models.providers モデルエントリは不要です。プロバイダー Plugin を有効化し、認証を設定し、モデルを選択します。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 はトランスポート選択を共有モデルランタイムに渡します。
• 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 は、サインイン済みアカウントが公開している場合、ChatGPT/Codex OAuth サブスクリプション認証経由で利用できます。OpenClaw は、このモデルについては直接の OpenAI API キーおよび Azure API キールートを引き続き抑制します。これらのトランスポートが拒否するためです

{  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 リクエストは、共有の /fast トグルと params.fastMode をサポートします。これには、api.anthropic.com に送信される API キーおよび OAuth 認証済みトラフィックが含まれます。OpenClaw はそれを Anthropic の service_tier（auto 対 standard_only）にマッピングします
• 推奨される Claude CLI 設定では、モデル参照を正規のままにし、CLI バックエンドを別に選択します。anthropic/claude-opus-4-8 に モデルスコープの agentRuntime.id: "claude-cli" を指定します。レガシー claude-cli/claude-opus-4-7 参照も互換性のため引き続き動作します。

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

OpenAI ChatGPT/Codex OAuth

• プロバイダー: openai
• 認証: OAuth（ChatGPT）
• レガシー OpenAI Codex モデル参照: openai/gpt-5.5
• ネイティブ Codex app-server ハーネス参照: openai/gpt-5.5
• ネイティブ Codex app-server ハーネスドキュメント: Codex ハーネス
• レガシーモデル参照: codex/gpt-*
• Plugin 境界: openai/* は OpenAI Plugin を読み込みます。ネイティブ Codex app-server Plugin は Codex ハーネスランタイムによって選択されます。
• CLI: openclaw onboard --auth-choice openai または openclaw models auth login --provider openai
• デフォルトのトランスポートは auto（WebSocket 優先、SSE フォールバック）です
• agents.defaults.models["openai/<model>"].params.transport（"sse"、"websocket"、または "auto"）で OpenAI Codex モデルごとに上書きします
• 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/gpt-5.5 は、Codex カタログネイティブの contextWindow = 400000 とデフォルトランタイムの contextTokens = 272000 を使用します。ランタイム上限は models.providers.openai.models[].contextTokens で上書きします
• ポリシーノート: OpenAI Codex OAuth は、OpenClaw のような外部ツール/ワークフローで明示的にサポートされています。
• 一般的なサブスクリプションとネイティブ Codex ランタイムのルートでは、openai 認証でサインインし、openai/gpt-5.5 を設定します。OpenAI エージェントターンはデフォルトで Codex を選択します。
• 組み込み OpenClaw ルートを使用したい場合にのみ、プロバイダー/モデルの agentRuntime.id: "openclaw" を使用します。それ以外の場合は、openai/gpt-5.5 をデフォルトの Codex ハーネスのままにしてください。
• レガシー Codex GPT 参照はレガシー状態であり、ライブプロバイダールートではありません。新しいエージェント設定にはネイティブ Codex ランタイム上の openai/gpt-5.5 を使用し、openclaw doctor --fix を実行して古いレガシー Codex モデル参照を正規の openai/* 参照に移行してください。

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

{  models: {    providers: {      openai: {        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 はデフォルトで stream-json を使用します。OpenClaw はアシスタントのストリーム メッセージを読み取り、stats.cached を cacheRead に正規化します。従来の --output-format json オーバーライドでも、response から返信テキストを読み取ります。

Z.AI (GLM)

• プロバイダー: zai
• 認証: ZAI_API_KEY
• モデル例: zai/glm-5.2
• CLI: openclaw onboard --auth-choice zai-api-key
  • モデル参照は正規の zai/* プロバイダー ID を使用します。
  • 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

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

知っておくべき癖

models.providers 経由のプロバイダー (カスタム/base URL)

カスタムプロバイダーまたは OpenAI/Anthropic 互換プロキシを追加するには、models.providers (または models.json) を使用します。

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

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

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

Moonshot AI (Kimi)

オンボーディングの前に @openclaw/moonshot-provider をインストールしてください。ベース 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.7-code
• 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 コーディング

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-M3 のままです
• 画像生成は 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_API_KEY でオプトインすると、Ollama は 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

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

関連

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