モデルプロバイダー

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

クイックルール

Control UI でプロバイダーを設定する

Control UI で 設定 → モデルプロバイダー を開き、models.providers.<id>.apiKey に保存されているプロバイダー API キーを追加、置換、または削除します。このページでは、各 API キーが OpenClaw の設定と環境変数のどちらから取得されたかを、認証情報を表示せずに識別できます。環境から提供されるキーは、引き続き Gateway プロセスの環境によって管理されます。

接続をテストを使用すると、プロバイダーへのライブプローブを実行し、レイテンシー、または認証、レート制限、請求、タイムアウト、レスポンスに分類されたエラーを確認できます。プローブは実際にプロバイダーへリクエストを送信するため、少量のトークンを消費する場合があります。OAuth およびトークンプロファイルは、プロバイダーカードからログアウトすることもできます。

デフォルトモデルカードでは、設定済みのモデルカタログからプライマリモデル、順序付きフォールバック、ユーティリティモデルを管理します。モデルを選択し、既存の agents.defaults.model および agents.defaults.utilityModel 設定にまとめて保存します。ユーティリティモデルでは、自動を選択すると設定が未設定のままになり、無効を選択すると空文字列が保存されてユーティリティルーティングが無効になります。

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.6。直接 API では、短い ID は Sol に解決されます。
• モデル例：openai/gpt-5.6、openai/gpt-5.6-terra、openai/gpt-5.6-luna、openai/gpt-5.5
• 特定のインストールまたは 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）は、汎用の OpenAI 互換プロキシではなく、api.openai.com へのネイティブ OpenAI トラフィックにのみ適用されます。
• ネイティブ OpenAI ルートでは、Responses の store、プロンプトキャッシュのヒント、OpenAI 推論互換のペイロード整形も維持されます。プロキシルートでは維持されません。
• openai/gpt-5.3-codex-spark は ChatGPT／Codex OAuth でのみ利用できます。OpenAI API キーおよび Azure API キーを直接使用するルートでは拒否されます。

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

API 組織が GPT-5.6 を公開していない場合は、 openai/gpt-5.5 を明示的に設定してください。通常のオンボーディングと再認証では、 既存の明示的なプライマリモデルが維持されます。models auth login --set-default と models set は、意図的に置き換えるための手段です。

Anthropic

• プロバイダー：anthropic
• 認証：ANTHROPIC_API_KEY
• 任意のローテーション：ANTHROPIC_API_KEYS、ANTHROPIC_API_KEY_1、ANTHROPIC_API_KEY_2、および OPENCLAW_LIVE_ANTHROPIC_KEY（単一オーバーライド）
• モデル例：anthropic/claude-opus-5
• 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 バックエンドを別途選択します。モデルスコープの agentRuntime.id: "claude-cli" を指定した anthropic/claude-opus-5 を使用します。従来の claude-cli/claude-opus-4-7 参照も互換性のため引き続き機能します。

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

OpenAI ChatGPT／Codex OAuth

• プロバイダー: openai
• 認証: OAuth (ChatGPT)
• 最新のネイティブ Codex app-server ハーネス参照: openai/gpt-5.6-sol
• ネイティブ Codex app-server ハーネスのドキュメント: Codex ハーネス
• レガシーモデル参照: codex/gpt-*、openai-codex/gpt-*
• Plugin 境界: openai/* は OpenAI Plugin を読み込みます。明示的なランタイムポリシーまたはプロバイダー所有の有効なルートによって、ネイティブ Codex app-server Plugin が選択されるかどうかが決まります。
• CLI: openclaw onboard --auth-choice openai または openclaw models auth login --provider openai
• OpenClaw に組み込まれた ChatGPT Responses トランスポートのデフォルトは auto（WebSocket 優先、SSE フォールバック）です。
• agents.defaults.models["openai/<model>"].params.transport、params.serviceTier、params.fastMode は、明示的に設定された組み込みリクエスト設定です。暗黙的なランタイム選択は OpenClaw が担当し、ネイティブ Codex は独自の app-server トランスポートとサービス階層を管理します。
• 非表示の OpenClaw 帰属ヘッダー（originator、version、User-Agent）は、汎用の OpenAI 互換プロキシではなく、chatgpt.com/backend-api へのネイティブ Codex トラフィックにのみ付加されます
• 共有の /fast トグルは引き続きランタイム制御として利用できます。これは明示的に設定されたモデルパラメーターとは別のものです。
• ネイティブ Codex カタログでは、アカウントのアクセス権に応じて、正確な openai/gpt-5.6-sol、openai/gpt-5.6-terra、openai/gpt-5.6-luna 参照を公開できます。直接 API の短縮 gpt-5.6 エイリアスをクライアント側で適用することはありません。
• openai/gpt-5.5 は Codex カタログのネイティブ contextWindow = 400000 とデフォルトランタイム contextTokens = 272000 を使用します。ランタイムの上限は models.providers.openai.models[].contextTokens で上書きします
• openai 認証でサインインし、サブスクリプションを利用する新規セットアップには openai/gpt-5.6-sol を使用します。その Codex ワークスペースで GPT-5.6 が公開されていない場合は、openai/gpt-5.5 を明示的に選択します。
• ほかの条件では対象となるルートを組み込みランタイムに維持するには、プロバイダー/モデル agentRuntime.id: "openclaw" を使用します。ランタイムが未設定または auto の場合、明示的なリクエスト上書きがない、公式の HTTPS Responses/ChatGPT 互換ルートと正確に一致する場合にのみ、Codex が暗黙的に選択される可能性があります。
• レガシー Codex GPT 参照はレガシー状態であり、稼働中のプロバイダールートではありません。新しいエージェント設定には正規の openai/* 参照を使用し、openclaw doctor --fix を実行して codex/* と openai-codex/* の参照を移行します。その際、モデルスコープの agentRuntime.id: "codex" によって、ネイティブ Codex のセマンティクスが維持されます。既存の明示的な正規 openai/gpt-5.5 選択はアップグレードされません。

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

{  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.5-flash
• 互換性: 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（カスタム/ベース URL）経由のプロバイダー

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

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

同梱されているルートおよびカタログで既知のルートは、その所有元プロバイダー Plugin から compat 機能を取得します。設定の compat ブロックは、カスタムプロバイダー/モデル、またはエンドポイント契約を検証済みの別の api/baseUrl ルート用です。カスタムプロバイダー機能ガイドを参照してください。Doctor は、カタログを単に繰り返すだけのレガシー値を削除し、異なる値はオペレーターが確認できるように残します。

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

agents.defaults.models["provider/model"] は、エージェントのエイリアスとモデルごとのメタデータを制御します。これ自体は上書きを制限せず、新しいランタイムモデルも登録しません。カスタムプロバイダーモデルの場合は、少なくとも一致する id を持つ models.providers.<provider>.models[] も追加します。上書きを制限する場合は、agents.defaults.modelPolicy.allow を別途使用します。

Moonshot AI（Kimi）

オンボーディングの前に @openclaw/moonshot-provider をインストールします。ベース URL またはモデルメタデータを上書きする必要がある場合にのみ、明示的な models.providers.moonshot エントリを追加します。

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

Kimi モデル ID:

• moonshot/kimi-k2.6
• moonshot/kimi-k3
• moonshot/kimi-k2.7-code
• moonshot/kimi-k2.7-code-highspeed
• moonshot/kimi-k2.5

{  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" }],      },    },  },}

完全なセットアップガイドについては、Moonshot AI（Kimi + Kimi Coding）を参照してください。

Kimi Coding

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

• プロバイダー: kimi
• 認証: KIMI_API_KEY
• Kimi K3: kimi/k3（256K）または kimi/k3[1m]（1M プラン）
• Kimi Code: kimi/kimi-for-coding
• Kimi Code HighSpeed: kimi/kimi-for-coding-highspeed

{  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-M3
• CLI: openclaw onboard --auth-choice synthetic-api-key

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

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
• ウェブ検索では引き続きプロバイダー 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

# Ollama をインストールしてから、モデルを取得します: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

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

関連項目

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