--- read_when: - プロバイダーごとのモデル設定リファレンスが必要です - モデルプロバイダー向けの設定例または CLI オンボーディングコマンドが必要です sidebarTitle: Model providers summary: モデルプロバイダーの概要と設定例 + CLI フロー title: モデルプロバイダー x-i18n: generated_at: "2026-05-11T20:28:02Z" model: gpt-5.5 provider: openai source_hash: 8a3cde106981c2601c0b127116c8b5968a9f95571245fc795e9a181243fc3b7e source_path: concepts/model-providers.md workflow: 16 --- **LLM/モデルプロバイダー**（WhatsApp/Telegram のようなチャットチャンネルではない）のリファレンスです。モデル選択ルールについては、[モデル](/ja-JP/concepts/models)を参照してください。 ## 基本ルール - モデル参照は `provider/model` を使用します（例: `opencode/claude-opus-4-6`）。 - `agents.defaults.models` は、設定されている場合は許可リストとして機能します。 - CLI ヘルパー: `openclaw onboard`、`openclaw models list`、`openclaw models set `。 - `models.providers.*.contextWindow` / `contextTokens` / `maxTokens` はプロバイダーレベルのデフォルトを設定します。`models.providers.*.models[].contextWindow` / `contextTokens` / `maxTokens` はモデルごとにそれらを上書きします。 - フォールバックルール、クールダウンプローブ、セッション上書きの永続化: [モデルフェイルオーバー](/ja-JP/concepts/model-failover)。 `openclaw configure` は、プロバイダーを追加または再認証するときに既存の `agents.defaults.model.primary` を保持します。`openclaw models auth login` も、`--set-default` を渡さない限り同じ動作です。プロバイダーPluginは認証設定パッチで推奨デフォルトモデルを返す場合がありますが、プライマリモデルがすでに存在する場合、OpenClaw はそれを「このモデルを利用可能にする」として扱い、「現在のプライマリモデルを置き換える」とは扱いません。 デフォルトモデルを意図的に切り替えるには、`openclaw models set ` または `openclaw models auth login --provider --set-default` を使用します。 OpenAI ファミリーのルートはプレフィックスごとに固有です。 - `openai/` は、デフォルトでエージェントターンにネイティブ Codex アプリサーバーハーネスを使用します。これは通常の ChatGPT/Codex サブスクリプション構成です。 - `openai-codex/` は、doctor が `openai/` に書き換えるレガシー設定です。 - `openai/` に加えてプロバイダー/モデルの `agentRuntime.id: "pi"` を指定すると、明示的な API キーまたは互換ルートに PI を使用します。 [OpenAI](/ja-JP/providers/openai) と [Codex ハーネス](/ja-JP/plugins/codex-harness)を参照してください。プロバイダー/ランタイム分離が分かりにくい場合は、先に[エージェントランタイム](/ja-JP/concepts/agent-runtimes)を読んでください。 Plugin の自動有効化も同じ境界に従います。`openai/*` エージェント参照はデフォルトルート用に Codex Plugin を有効化し、明示的なプロバイダー/モデルの `agentRuntime.id: "codex"` またはレガシー `codex/` 参照もそれを必要とします。 GPT-5.5 は、デフォルトでは `openai/gpt-5.5` のネイティブ Codex アプリサーバーハーネス経由で利用でき、プロバイダー/モデルのランタイムポリシーが明示的に `pi` を選択した場合にのみ PI 経由で利用できます。 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](/ja-JP/plugins/sdk-provider-plugins)にあります。完全にカスタムのリクエスト実行機構を必要とするプロバイダーは、別のより深い拡張サーフェスです。 プロバイダー所有のランナー動作は、リプレイポリシー、ツールスキーマ正規化、ストリームラップ、トランスポート/リクエストヘルパーなどの明示的なプロバイダーフックにあります。レガシーの `ProviderPlugin.capabilities` 静的バッグは互換性専用であり、共有ランナーロジックではもう読み取られません。 ## API キーローテーション 複数のキーは次で設定します。 - `OPENCLAW_LIVE__KEY`（単一のライブ上書き、最優先） - `_API_KEYS`（カンマまたはセミコロン区切りリスト） - `_API_KEY`（プライマリキー） - `_API_KEY_*`（番号付きリスト、例: `_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/"].params.transport`（`"sse"`、`"websocket"`、または `"auto"`）で上書きします。 - OpenAI 優先処理は `agents.defaults.models["openai/"].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 では意図的に抑制されています。 ```json5 { 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` を優先します。 ```json5 { 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 ハーネス](/ja-JP/plugins/codex-harness) - レガシーモデル参照: `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/"].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 ランタイムルートを使用してください。 ```json5 { plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.5" }, }, }, } ``` ```json5 { models: { providers: { "openai-codex": { models: [{ id: "gpt-5.5", contextTokens: 160000 }], }, }, }, } ``` ### その他のサブスクリプション型ホストオプション Z.AI Coding Plan または一般 API エンドポイント。 MiniMax Coding Plan OAuth または API キーアクセス。 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` ```json5 { 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/"].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 の一部として提供されます。 ```bash brew install gemini-cli ``` ```bash npm install -g @google/gemini-cli ``` ```bash openclaw plugins enable google ``` ```bash 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](/ja-JP/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.ai` ルートでのみ、アプリ帰属ヘッダーと Anthropic の `cache_control` マーカーを適用します。DeepSeek、Moonshot、ZAI の参照は、OpenRouter 管理のプロンプトキャッシュで cache-TTL の対象になりますが、Anthropic のキャッシュマーカーは受け取りません。プロキシ形式の OpenAI 互換パスとして、ネイティブ OpenAI 専用の整形（`serviceTier`、Responses の `store`、プロンプトキャッシュヒント、OpenAI 推論互換）はスキップします。Gemini バックエンドの参照では、プロキシ Gemini の思考シグネチャのサニタイズのみを保持します。 Gemini バックエンドの参照は同じプロキシ Gemini サニタイズパスに従います。`kilocode/kilo/auto` とその他のプロキシ推論非対応の参照では、プロキシ推論の注入をスキップします。 API キーのオンボーディングでは、明示的なテキスト専用 M2.7 チャットモデル定義を書き込みます。画像理解は、Plugin 所有の `MiniMax-VL-01` メディアプロバイダーに残ります。 モデル ID は `nvidia//` 名前空間を使います（たとえば `nvidia/moonshotai/kimi-k2.5` と並ぶ `nvidia/nvidia/nemotron-...`）。ピッカーはリテラルの `/` 構成を保持しますが、API に送信される正規キーは単一プレフィックスのままです。 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/"].params.tool_stream=false` を使います。 同梱の `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.` エントリを使ってください。 Gateway のモデル機能チェックは、明示的な `models.providers..models[]` メタデータも読み取ります。カスタムモデルまたはプロキシモデルが画像を受け付ける場合は、そのモデルに `input: ["text", "image"]` を設定し、WebChat とノード由来の添付ファイルパスが、テキスト専用メディア参照ではなくネイティブモデル入力として画像を渡せるようにします。 `agents.defaults.models["provider/model"]` は、エージェント向けのモデル表示、エイリアス、モデルごとのメタデータだけを制御します。それ自体では新しいランタイムモデルを登録しません。カスタムプロバイダーモデルでは、少なくとも一致する `id` を含む `models.providers..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-model-refs:start" - `moonshot/kimi-k2.6` - `moonshot/kimi-k2.5` - `moonshot/kimi-k2-thinking` - `moonshot/kimi-k2-thinking-turbo` - `moonshot/kimi-k2-turbo` [//]: # "moonshot-kimi-k2-model-refs:end" ```json5 { 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` ```json5 { 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` ```json5 { agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" } }, }, } ``` オンボーディングではデフォルトでコーディングサーフェスが使用されますが、汎用の `volcengine/*` カタログも同時に登録されます。 オンボーディング/設定のモデルピッカーでは、Volcengine の認証選択は `volcengine/*` と `volcengine-plan/*` の両方の行を優先します。これらのモデルがまだ読み込まれていない場合、OpenClaw は空のプロバイダースコープのピッカーを表示する代わりに、フィルターなしのカタログにフォールバックします。 - `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` ```json5 { agents: { defaults: { model: { primary: "byteplus-plan/ark-code-latest" } }, }, } ``` オンボーディングではデフォルトでコーディングサーフェスが使用されますが、汎用の `byteplus/*` カタログも同時に登録されます。 オンボーディング/設定のモデルピッカーでは、BytePlus の認証選択は `byteplus/*` と `byteplus-plan/*` の両方の行を優先します。これらのモデルがまだ読み込まれていない場合、OpenClaw は空のプロバイダースコープのピッカーを表示する代わりに、フィルターなしのカタログにフォールバックします。 - `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` ```json5 { 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](/ja-JP/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 のいずれかに置き換えてください)。 ```json5 { 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](/ja-JP/providers/lmstudio) を参照してください。 ### Ollama Ollama はバンドル済みプロバイダー Plugin として提供され、Ollama のネイティブ API を使用します。 - プロバイダー: `ollama` - 認証: 不要 (ローカルサーバー) - モデル例: `ollama/llama3.3` - インストール: [https://ollama.com/download](https://ollama.com/download) ```bash # Install Ollama, then pull a model: ollama pull llama3.3 ``` ```json5 { agents: { defaults: { model: { primary: "ollama/llama3.3" } }, }, } ``` Ollama は `OLLAMA_API_KEY` でオプトインすると `http://127.0.0.1:11434` でローカル検出され、バンドル済みプロバイダー Plugin が Ollama を `openclaw onboard` とモデルピッカーに直接追加します。オンボーディング、クラウド/ローカルモード、カスタム設定については [/providers/ollama](/ja-JP/providers/ollama) を参照してください。 ### vLLM vLLM は、ローカル/セルフホストの OpenAI 互換サーバー向けのバンドル済みプロバイダー Plugin として提供されます。 - プロバイダー: `vllm` - 認証: 任意 (サーバーによって異なります) - デフォルトのベース URL: `http://127.0.0.1:8000/v1` ローカルで自動検出にオプトインするには (サーバーが認証を強制しない場合は任意の値で機能します)。 ```bash export VLLM_API_KEY="vllm-local" ``` 次にモデルを設定します (`/v1/models` が返す ID のいずれかに置き換えてください)。 ```json5 { agents: { defaults: { model: { primary: "vllm/your-model-id" } }, }, } ``` 詳細については [/providers/vllm](/ja-JP/providers/vllm) を参照してください。 ### SGLang SGLang は、高速なセルフホストの OpenAI 互換サーバー向けのバンドル済みプロバイダー Plugin として提供されます。 - プロバイダー: `sglang` - 認証: 任意 (サーバーによって異なります) - デフォルトのベース URL: `http://127.0.0.1:30000/v1` ローカルで自動検出にオプトインするには (サーバーが認証を強制しない場合は任意の値で機能します)。 ```bash export SGLANG_API_KEY="sglang-local" ``` 次にモデルを設定します (`/v1/models` が返す ID のいずれかに置き換えてください)。 ```json5 { agents: { defaults: { model: { primary: "sglang/your-model-id" } }, }, } ``` 詳細については [/providers/sglang](/ja-JP/providers/sglang) を参照してください。 ### ローカルプロキシ (LM Studio、vLLM、LiteLLM など) 例 (OpenAI 互換): ```json5 { 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..timeoutSeconds` を設定します。これにより、エージェント実行時間全体のタイムアウトを増やすことなく、接続、ヘッダー、本文ストリーミング、保護された fetch 全体の中断を含むプロバイダーモデル HTTP リクエスト処理が延長されます。 - モデルプロバイダー HTTP 呼び出しでは、設定されたプロバイダー `baseUrl` ホスト名に対してのみ、Surge、Clash、sing-box の fake-IP DNS 応答を `198.18.0.0/15` と `fc00::/7` で許可します。その他のプライベート、ループバック、リンクローカル、メタデータ宛先では、引き続き明示的な `models.providers..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..headers["anthropic-beta"]` を明示的に設定してください。 ## CLI の例 ```bash openclaw onboard --auth-choice opencode-zen openclaw models set opencode/claude-opus-4-6 openclaw models list ``` 完全な設定例については、[設定](/ja-JP/gateway/configuration) も参照してください。 ## 関連 - [設定リファレンス](/ja-JP/gateway/config-agents#agent-defaults) - モデル設定キー - [モデルフェイルオーバー](/ja-JP/concepts/model-failover) - フォールバックチェーンと再試行動作 - [モデル](/ja-JP/concepts/models) - モデル設定とエイリアス - [プロバイダー](/ja-JP/providers) - プロバイダーごとのセットアップガイド