モデルプロバイダー

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.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 は、api.openai.com への直接 openai/* Responses リクエストを 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 経由でのみ利用できます。直接 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-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）
• 新規のネイティブ Codex app-server ハーネス参照: openai/gpt-5.6-sol
• ネイティブ Codex app-server ハーネスのドキュメント: Codex ハーネス
• 旧モデル参照: 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）は、chatgpt.com/backend-api へのネイティブ Codex トラフィックにのみ付加され、汎用の OpenAI 互換プロキシには付加されません。
• 共有の /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 を実行して、既存の明示的な openai/gpt-5.5 選択をアップグレードすることなく、古い旧 Codex モデル参照を移行してください。

{  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経由のプロバイダー（カスタム/base URL）

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

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

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

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

Moonshot AI（Kimi）

オンボーディング前に@openclaw/moonshot-providerをインストールします。base 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" }],      },    },  },}

完全な設定ガイドについては、Moonshot AI（Kimi + Kimi Coding）を参照してください。

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-M3
• 画像生成はminimax/image-01またはminimax-portal/image-01
• 画像理解は両方のMiniMax認証パスでPluginが所有するMiniMax-VL-01
• Web検索では引き続きプロバイダーIDminimaxを使用

LM Studio

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

• プロバイダー: lmstudio
• 認証: LM_API_TOKEN
• 既定の推論base 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
• 認証: 任意（サーバーによる）
• 既定のbase 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
• 認証: 任意（サーバーによる）
• 既定のbase 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

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

関連項目

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