モデルプロバイダー

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

基本ルール

モデル参照と CLI ヘルパー

モデル参照は provider/model を使用します（例: opencode/claude-opus-4-6）。
agents.defaults.models は、設定されている場合は許可リストとして機能します。
CLI ヘルパー: openclaw onboard、openclaw models list、openclaw models set <provider/model>。
models.providers.*.contextWindow / contextTokens / maxTokens はプロバイダーレベルのデフォルトを設定します。models.providers.*.models[].contextWindow / contextTokens / maxTokens はモデルごとにそれらを上書きします。
フォールバックルール、クールダウンプローブ、セッション上書きの永続化: モデルフェイルオーバー。

プロバイダー認証を追加してもプライマリモデルは変更されません

openclaw configure は、プロバイダーを追加または再認証するときに既存の agents.defaults.model.primary を保持します。openclaw models auth login も、--set-default を渡さない限り同じ動作です。プロバイダーPluginは認証設定パッチで推奨デフォルトモデルを返す場合がありますが、プライマリモデルがすでに存在する場合、OpenClaw はそれを「このモデルを利用可能にする」として扱い、「現在のプライマリモデルを置き換える」とは扱いません。デフォルトモデルを意図的に切り替えるには、openclaw models set <provider/model> または openclaw models auth login --provider <id> --set-default を使用します。

OpenAI プロバイダー/ランタイム分離

OpenAI ファミリーのルートはプレフィックスごとに固有です。

openai/<model> は、デフォルトでエージェントターンにネイティブ Codex アプリサーバーハーネスを使用します。これは通常の ChatGPT/Codex サブスクリプション構成です。
openai-codex/<model> は、doctor が openai/<model> に書き換えるレガシー設定です。
openai/<model> に加えてプロバイダー/モデルの agentRuntime.id: "pi" を指定すると、明示的な API キーまたは互換ルートに PI を使用します。

OpenAI と Codex ハーネスを参照してください。プロバイダー/ランタイム分離が分かりにくい場合は、先にエージェントランタイムを読んでください。Plugin の自動有効化も同じ境界に従います。openai/* エージェント参照はデフォルトルート用に Codex Plugin を有効化し、明示的なプロバイダー/モデルの agentRuntime.id: "codex" またはレガシー codex/<model> 参照もそれを必要とします。GPT-5.5 は、デフォルトでは openai/gpt-5.5 のネイティブ Codex アプリサーバーハーネス経由で利用でき、プロバイダー/モデルのランタイムポリシーが明示的に pi を選択した場合にのみ PI 経由で利用できます。

CLI ランタイム

CLI ランタイムも同じ分離を使用します。anthropic/claude-*、google/gemini-*、openai/gpt-* などの正規モデル参照を選択し、ローカル CLI バックエンドを使いたい場合はプロバイダー/モデルのランタイムポリシーを claude-cli、google-gemini-cli、または codex-cli に設定します。レガシーの claude-cli/*、google-gemini-cli/*、codex-cli/* 参照は、ランタイムを別に記録したうえで正規プロバイダー参照へ移行されます。

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

プロバイダー固有ロジックの大半はプロバイダーPlugin（registerProvider(...)）にあり、OpenClaw は汎用推論ループを保持します。Plugin は、オンボーディング、モデルカタログ、認証環境変数のマッピング、トランスポート/設定の正規化、ツールスキーマのクリーンアップ、フェイルオーバー分類、OAuth 更新、使用量レポート、思考/推論プロファイルなどを所有します。プロバイダー SDK フックとバンドルPlugin例の完全な一覧は、プロバイダーPluginにあります。完全にカスタムのリクエスト実行機構を必要とするプロバイダーは、別のより深い拡張サーフェスです。

プロバイダー所有のランナー動作は、リプレイポリシー、ツールスキーマ正規化、ストリームラップ、トランスポート/リクエストヘルパーなどの明示的なプロバイダーフックにあります。レガシーの ProviderPlugin.capabilities 静的バッグは互換性専用であり、共有ランナーロジックではもう読み取られません。

API キーローテーション

キーのソースと優先順位

複数のキーは次で設定します。

OPENCLAW_LIVE_<PROVIDER>_KEY（単一のライブ上書き、最優先）
<PROVIDER>_API_KEYS（カンマまたはセミコロン区切りリスト）
<PROVIDER>_API_KEY（プライマリキー）
<PROVIDER>_API_KEY_*（番号付きリスト、例: <PROVIDER>_API_KEY_1）

Google プロバイダーでは、GOOGLE_API_KEY もフォールバックとして含まれます。キー選択順序は優先順位を保持し、値を重複排除します。

ローテーションが発動するタイミング

リクエストは、レート制限レスポンスの場合にのみ次のキーで再試行されます（例: 429、rate_limit、quota、resource exhausted、Too many concurrent requests、ThrottlingException、concurrency limit reached、workers_ai ... quota limit exceeded、または定期的な使用量制限メッセージ）。
レート制限以外の失敗は即時に失敗します。キーローテーションは試行されません。
すべての候補キーが失敗した場合、最後の試行からの最終エラーが返されます。

組み込みプロバイダー（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 参照も互換性のため引き続き動作します。

Anthropic スタッフは OpenClaw スタイルの Claude CLI 利用が再び許可されたと伝えたため、Anthropic が新しいポリシーを公開しない限り、OpenClaw はこの統合における Claude CLI 再利用と claude -p 利用を認可されたものとして扱います。Anthropic setup-token はサポート済みの OpenClaw トークンパスとして引き続き利用できますが、OpenClaw は現在、利用可能な場合は Claude CLI 再利用と claude -p を優先します。

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

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

GLM モデル

Z.AI Coding Plan または一般 API エンドポイント。

MiniMax

MiniMax Coding Plan OAuth または API キーアクセス。

Qwen Cloud

Qwen Cloud プロバイダーサーフェスに加えて、Alibaba DashScope と Coding Plan エンドポイントマッピング。

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 フローを使用します

OpenClaw の Gemini CLI OAuth は非公式の統合です。一部のユーザーは、サードパーティクライアントの使用後に Google アカウントの制限を報告しています。続行する場合は Google の規約を確認し、重要でないアカウントを使用してください。

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

Gemini CLI をインストール

brew
npm

brew install gemini-cli

npm install -g @google/gemini-cli

Plugin を有効化

openclaw plugins enable google

ログイン

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

デフォルトモデル: google-gemini-cli/gemini-3-flash-preview。クライアント ID やシークレットを openclaw.json に貼り付ける必要はありません。CLI ログインフローは、Gateway ホスト上の認証プロファイルにトークンを保存します。

プロジェクトを設定（必要な場合）

ログイン後にリクエストが失敗する場合は、Gateway ホストで GOOGLE_CLOUD_PROJECT または GOOGLE_CLOUD_PROJECT_ID を設定してください。

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

プロバイダー	ID	認証環境変数	モデル例
BytePlus	`byteplus` / `byteplus-plan`	`BYTEPLUS_API_KEY`	`byteplus-plan/ark-code-latest`
Cerebras	`cerebras`	`CEREBRAS_API_KEY`	`cerebras/zai-glm-4.7`
Cloudflare AI Gateway	`cloudflare-ai-gateway`	`CLOUDFLARE_AI_GATEWAY_API_KEY`	-
DeepInfra	`deepinfra`	`DEEPINFRA_API_KEY`	`deepinfra/deepseek-ai/DeepSeek-V3.2`
DeepSeek	`deepseek`	`DEEPSEEK_API_KEY`	`deepseek/deepseek-v4-flash`
GitHub Copilot	`github-copilot`	`COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN`	-
Groq	`groq`	`GROQ_API_KEY`	-
Hugging Face Inference	`huggingface`	`HUGGINGFACE_HUB_TOKEN` または `HF_TOKEN`	`huggingface/deepseek-ai/DeepSeek-R1`
Kilo Gateway	`kilocode`	`KILOCODE_API_KEY`	`kilocode/kilo/auto`
Kimi Coding	`kimi`	`KIMI_API_KEY` または `KIMICODE_API_KEY`	`kimi/kimi-for-coding`
MiniMax	`minimax` / `minimax-portal`	`MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN`	`minimax/MiniMax-M2.7`
Mistral	`mistral`	`MISTRAL_API_KEY`	`mistral/mistral-large-latest`
Moonshot	`moonshot`	`MOONSHOT_API_KEY`	`moonshot/kimi-k2.6`
NVIDIA	`nvidia`	`NVIDIA_API_KEY`	`nvidia/nvidia/nemotron-3-super-120b-a12b`
OpenRouter	`openrouter`	`OPENROUTER_API_KEY`	`openrouter/auto`
Qianfan	`qianfan`	`QIANFAN_API_KEY`	`qianfan/deepseek-v3.2`
Qwen Cloud	`qwen`	`QWEN_API_KEY` / `MODELSTUDIO_API_KEY` / `DASHSCOPE_API_KEY`	`qwen/qwen3.5-plus`
StepFun	`stepfun` / `stepfun-plan`	`STEPFUN_API_KEY`	`stepfun/step-3.5-flash`
Together	`together`	`TOGETHER_API_KEY`	`together/moonshotai/Kimi-K2.5`
Venice	`venice`	`VENICE_API_KEY`	-
Vercel AI Gateway	`vercel-ai-gateway`	`AI_GATEWAY_API_KEY`	`vercel-ai-gateway/anthropic/claude-opus-4.6`
Volcano Engine (Doubao)	`volcengine` / `volcengine-plan`	`VOLCANO_ENGINE_API_KEY`	`volcengine-plan/ark-code-latest`
xAI	`xai`	`XAI_API_KEY`	`xai/grok-4.3`
Xiaomi	`xiaomi`	`XIAOMI_API_KEY`	`xiaomi/mimo-v2-flash`

知っておくべき癖

OpenRouter

検証済みの openrouter.ai ルートでのみ、アプリ帰属ヘッダーと Anthropic の cache_control マーカーを適用します。DeepSeek、Moonshot、ZAI の参照は、OpenRouter 管理のプロンプトキャッシュで cache-TTL の対象になりますが、Anthropic のキャッシュマーカーは受け取りません。プロキシ形式の OpenAI 互換パスとして、ネイティブ OpenAI 専用の整形（serviceTier、Responses の store、プロンプトキャッシュヒント、OpenAI 推論互換）はスキップします。Gemini バックエンドの参照では、プロキシ Gemini の思考シグネチャのサニタイズのみを保持します。

Kilo Gateway

Gemini バックエンドの参照は同じプロキシ Gemini サニタイズパスに従います。kilocode/kilo/auto とその他のプロキシ推論非対応の参照では、プロキシ推論の注入をスキップします。

MiniMax

API キーのオンボーディングでは、明示的なテキスト専用 M2.7 チャットモデル定義を書き込みます。画像理解は、Plugin 所有の MiniMax-VL-01 メディアプロバイダーに残ります。

NVIDIA

モデル ID は nvidia/<vendor>/<model> 名前空間を使います（たとえば nvidia/moonshotai/kimi-k2.5 と並ぶ nvidia/nvidia/nemotron-...）。ピッカーはリテラルの <provider>/<model-id> 構成を保持しますが、API に送信される正規キーは単一プレフィックスのままです。

xAI

xAI Responses パスを使用します。grok-4.3 は同梱のデフォルトチャットモデルです。/fast または params.fastMode: true は、grok-3、grok-3-mini、grok-4、grok-4-0709 をそれぞれの *-fast バリアントに書き換えます。tool_stream はデフォルトで有効です。無効にするには agents.defaults.models["xai/<model>"].params.tool_stream=false を使います。

Cerebras

同梱の cerebras プロバイダー Plugin として提供されます。GLM は zai-glm-4.7 を使用します。OpenAI 互換のベース URL は https://api.cerebras.ai/v1 です。

`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 は空のプロバイダースコープのピッカーを表示する代わりに、フィルターなしのカタログにフォールバックします。

標準モデル
コーディングモデル (volcengine-plan)

volcengine/doubao-seed-1-8-251228 (Doubao Seed 1.8)
volcengine/doubao-seed-code-preview-251028
volcengine/kimi-k2-5-260127 (Kimi K2.5)
volcengine/glm-4-7-251222 (GLM 4.7)
volcengine/deepseek-v3-2-251201 (DeepSeek V3.2 128K)

volcengine-plan/ark-code-latest
volcengine-plan/doubao-seed-code
volcengine-plan/kimi-k2.5
volcengine-plan/kimi-k2-thinking
volcengine-plan/glm-4.7

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 は空のプロバイダースコープのピッカーを表示する代わりに、フィルターなしのカタログにフォールバックします。

標準モデル
コーディングモデル (byteplus-plan)

byteplus/seed-1-8-251228 (Seed 1.8)
byteplus/kimi-k2-5-260127 (Kimi K2.5)
byteplus/glm-4-7-251222 (GLM 4.7)

byteplus-plan/ark-code-latest
byteplus-plan/doubao-seed-code
byteplus-plan/kimi-k2.5
byteplus-plan/kimi-k2-thinking
byteplus-plan/glm-4.7

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 を参照してください。

MiniMax の Anthropic 互換ストリーミングパスでは、OpenClaw は明示的に設定されていない限りデフォルトで thinking を無効にし、/fast on は MiniMax-M2.7 を MiniMax-M2.7-highspeed に書き換えます。

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

デフォルトの任意フィールド

カスタムプロバイダーでは、reasoning、input、cost、contextWindow、maxTokens は任意です。省略した場合、OpenClaw のデフォルトは次のとおりです。

reasoning: false
input: ["text"]
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
contextWindow: 200000
maxTokens: 8192

推奨: プロキシ/モデルの制限に一致する明示的な値を設定してください。

プロキシルート整形ルール

非ネイティブエンドポイント (ホストが api.openai.com ではない、空でない任意の baseUrl) で api: "openai-completions" を使用する場合、OpenClaw は未対応の developer ロールによるプロバイダー 400 エラーを避けるため、compat.supportsDeveloperRole: false を強制します。
プロキシ形式の OpenAI 互換ルートでは、ネイティブ OpenAI 専用のリクエスト整形もスキップされます。service_tier なし、Responses store なし、Completions store なし、プロンプトキャッシュヒントなし、OpenAI reasoning 互換ペイロード整形なし、隠し OpenClaw 帰属ヘッダーなしです。
ベンダー固有フィールドが必要な OpenAI 互換 Completions プロキシでは、agents.defaults.models["provider/model"].params.extra_body (または extraBody) を設定して、送信リクエスト本文に追加 JSON をマージします。
vLLM チャットテンプレート制御では、agents.defaults.models["provider/model"].params.chat_template_kwargs を設定します。バンドル済み vLLM Plugin は、セッション thinking レベルがオフの場合、vllm/nemotron-3-* に対して enable_thinking: false と force_nonempty_content: true を自動的に送信します。
遅いローカルモデルやリモート LAN/tailnet ホストでは、models.providers.<id>.timeoutSeconds を設定します。これにより、エージェント実行時間全体のタイムアウトを増やすことなく、接続、ヘッダー、本文ストリーミング、保護された fetch 全体の中断を含むプロバイダーモデル HTTP リクエスト処理が延長されます。
モデルプロバイダー HTTP 呼び出しでは、設定されたプロバイダー baseUrl ホスト名に対してのみ、Surge、Clash、sing-box の fake-IP DNS 応答を 198.18.0.0/15 と fc00::/7 で許可します。その他のプライベート、ループバック、リンクローカル、メタデータ宛先では、引き続き明示的な models.providers.<id>.request.allowPrivateNetwork: true オプトインが必要です。
baseUrl が空または省略されている場合、OpenClaw はデフォルトの OpenAI 動作を維持します (これは api.openai.com に解決されます)。
安全のため、明示的な compat.supportsDeveloperRole: true は、非ネイティブの openai-completions エンドポイントでも上書きされます。
非直接エンドポイント (正規の anthropic 以外の任意のプロバイダー、またはホストが公開 api.anthropic.com エンドポイントではないカスタム models.providers.anthropic.baseUrl) で api: "anthropic-messages" を使用する場合、OpenClaw は claude-code-20250219、interleaved-thinking-2025-05-14、OAuth マーカーなどの暗黙的な Anthropic ベータヘッダーを抑制し、カスタム Anthropic 互換プロキシが未対応のベータフラグを拒否しないようにします。プロキシに特定のベータ機能が必要な場合は、models.providers.<id>.headers["anthropic-beta"] を明示的に設定してください。

CLI の例

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

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

Overview

Concepts and configuration

Providers

モデルプロバイダー

基本ルール

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

API キーローテーション

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

OpenAI

Anthropic

OpenAI Codex OAuth

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

GLM モデル

MiniMax

Qwen Cloud

OpenCode

Google Gemini（API キー）

Google Vertex と Gemini CLI

Z.AI (GLM)

Vercel AI Gateway

Kilo Gateway

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

知っておくべき癖

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

Moonshot AI (Kimi)

Kimi coding

Volcano Engine (Doubao)

BytePlus (国際)

Synthetic

MiniMax

LM Studio

Ollama

vLLM

SGLang

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

CLI の例

関連

Overview

Concepts and configuration

Providers

Documentation Index

​基本ルール

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

​API キーローテーション

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

​OpenAI

​Anthropic

​OpenAI Codex OAuth

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

GLM モデル

MiniMax

Qwen Cloud

​OpenCode

​Google Gemini（API キー）

​Google Vertex と Gemini CLI

​Z.AI (GLM)

​Vercel AI Gateway

​Kilo Gateway

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

​知っておくべき癖

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

​Moonshot AI (Kimi)

​Kimi coding

​Volcano Engine (Doubao)

​BytePlus (国際)

​Synthetic

​MiniMax

​LM Studio

​Ollama

​vLLM

​SGLang

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

​CLI の例

​関連

基本ルール

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

API キーローテーション

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

OpenAI

Anthropic

OpenAI Codex OAuth

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

OpenCode

Google Gemini（API キー）

Google Vertex と Gemini CLI

Z.AI (GLM)

Vercel AI Gateway

Kilo Gateway

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

知っておくべき癖

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

Moonshot AI (Kimi)

Kimi coding

Volcano Engine (Doubao)

BytePlus (国際)

Synthetic

MiniMax

LM Studio

Ollama

vLLM

SGLang

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

CLI の例

関連