--- read_when: - プロバイダー別のモデル設定リファレンスが必要です - モデルプロバイダー向けの設定例または CLI オンボーディングコマンドが必要な場合 sidebarTitle: Model providers summary: モデルプロバイダーの概要と設定例 + CLI フロー title: モデルプロバイダー x-i18n: generated_at: "2026-07-04T03:35:22Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 410c92229de01cbb2be185e6cd1e2a07e554c7c5aacb356f4a9ffd1bce268de2 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 app-server ハーネスを使用します。これは通常の ChatGPT/Codex サブスクリプション設定です。 - レガシー Codex モデル参照は、doctor が `openai/` に書き換えるレガシー設定です。 - `openai/` に加えてプロバイダー/モデルの `agentRuntime.id: "openclaw"` を使用すると、明示的な API キーまたは互換性ルート向けに OpenClaw の組み込みランタイムを使用します。 [OpenAI](/ja-JP/providers/openai) と [Codex ハーネス](/ja-JP/plugins/codex-harness)を参照してください。プロバイダー/ランタイムの分割がわかりにくい場合は、先に[エージェントランタイム](/ja-JP/concepts/agent-runtimes)を読んでください。 Plugin の自動有効化も同じ境界に従います。`openai/*` エージェント参照はデフォルトルート用に Codex Plugin を有効化し、明示的なプロバイダー/モデルの `agentRuntime.id: "codex"` またはレガシー `codex/` 参照でも同じ Plugin が必要です。 GPT-5.5 は、デフォルトでは `openai/gpt-5.5` 上のネイティブ Codex app-server ハーネス経由で利用でき、プロバイダー/モデルのランタイムポリシーで `openclaw` を明示的に選択した場合は OpenClaw ランタイム経由で利用できます。 CLI ランタイムも同じ分割を使用します。`anthropic/claude-*` や `google/gemini-*` などの正規モデル参照を選択し、ローカル CLI バックエンドを使用したい場合はプロバイダー/モデルのランタイムポリシーを `claude-cli` または `google-gemini-cli` に設定します。 レガシー `claude-cli/*` と `google-gemini-cli/*` 参照は、ランタイムを別に記録したうえで正規プロバイダー参照へ戻るよう移行されます。レガシー `codex-cli/*` 参照は `openai/*` に移行され、Codex app-server ルートを使用します。OpenClaw は、バンドルされた 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`、または定期的な使用量制限メッセージ）。 - レート制限以外の失敗は即座に失敗します。キーのローテーションは試行されません。 - すべての候補キーが失敗した場合、最後の試行からの最終エラーが返されます。 ## 公式プロバイダー 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/"].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` は、サインイン済みアカウントが公開している場合、ChatGPT/Codex OAuth サブスクリプション認証経由で利用できます。OpenClaw は、このモデルについては直接の OpenAI API キーおよび Azure API キールートを引き続き抑制します。これらのトランスポートが拒否するためです ```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 リクエストは、共有の `/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` 参照も互換性のため引き続き動作します。 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 ChatGPT/Codex OAuth - プロバイダー: `openai` - 認証: OAuth（ChatGPT） - レガシー OpenAI Codex モデル参照: `openai/gpt-5.5` - ネイティブ Codex app-server ハーネス参照: `openai/gpt-5.5` - ネイティブ Codex app-server ハーネスドキュメント: [Codex ハーネス](/ja-JP/plugins/codex-harness) - レガシーモデル参照: `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/"].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/*` 参照に移行してください。 ```json5 { plugins: { entries: { codex: { enabled: true } } }, agents: { defaults: { model: { primary: "openai/gpt-5.5" }, }, }, } ``` ```json5 { models: { providers: { openai: { 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 はデフォルトで `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 | プロバイダー | ID | 認証環境変数 | モデル例 | | --------------------------------------- | -------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------- | | BytePlus | `byteplus` / `byteplus-plan` | `BYTEPLUS_API_KEY` | `byteplus-plan/ark-code-latest` | | ClawRouter | `clawrouter` | `CLAWROUTER_API_KEY` | `clawrouter/anthropic/claude-sonnet-4-6` | | Cohere | `cohere` | `COHERE_API_KEY` | `cohere/command-a-03-2025` | | GitHub Copilot | `github-copilot` | `COPILOT_GITHUB_TOKEN` / `GH_TOKEN` / `GITHUB_TOKEN` | - | | Hugging Face Inference | `huggingface` | `HUGGINGFACE_HUB_TOKEN` または `HF_TOKEN` | `huggingface/deepseek-ai/DeepSeek-R1` | | MiniMax | `minimax` / `minimax-portal` | `MINIMAX_API_KEY` / `MINIMAX_OAUTH_TOKEN` | `minimax/MiniMax-M3` | | 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-ultra-550b-a55b` | | NovitaAI | `novita` | `NOVITA_API_KEY` | `novita/deepseek/deepseek-v3-0324` | | [Ollama Cloud](/ja-JP/providers/ollama-cloud) | `ollama-cloud` | `OLLAMA_API_KEY` | `ollama-cloud/kimi-k2.6` | | OpenRouter | `openrouter` | OpenRouter OAuth または `OPENROUTER_API_KEY` | `openrouter/auto` | | [Qwen OAuth](/ja-JP/providers/qwen-oauth) | `qwen-oauth` | `QWEN_API_KEY` | `qwen-oauth/qwen3.5-plus` | | Together | `together` | `TOGETHER_API_KEY` | `together/meta-llama/Llama-3.3-70B-Instruct-Turbo` | | 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` | SuperGrok/X Premium OAuth または `XAI_API_KEY` | `xai/grok-4.3` | | Xiaomi | `xiaomi` / `xiaomi-token-plan` | `XIAOMI_API_KEY` / `XIAOMI_TOKEN_PLAN_API_KEY` | `xiaomi/mimo-v2-flash` / `xiaomi-token-plan/mimo-v2.5-pro` | #### 知っておくべき癖 検証済みの `openrouter.ai` ルートでのみ、アプリ帰属ヘッダーと Anthropic の `cache_control` マーカーを適用します。DeepSeek、Moonshot、ZAI の参照は OpenRouter 管理のプロンプトキャッシュについてキャッシュ TTL 対象ですが、Anthropic のキャッシュマーカーは受け取りません。プロキシ形式の OpenAI 互換パスとして、ネイティブ OpenAI 専用の整形 (`serviceTier`、Responses `store`、プロンプトキャッシュヒント、OpenAI reasoning 互換) はスキップします。Gemini バックエンドの参照は、プロキシ Gemini の思考署名サニタイズのみ保持します。 Gemini バックエンドの参照は同じプロキシ Gemini サニタイズパスに従います。`kilocode/kilo/auto` とその他のプロキシ reasoning 非対応参照は、プロキシ reasoning 注入をスキップします。 API キーのオンボーディングは、明示的な M3 と M2.7 チャットモデル定義を書き込みます。画像理解は Plugin が所有する `MiniMax-VL-01` メディアプロバイダーに残ります。 モデル ID は `nvidia//` 名前空間を使用します (たとえば `nvidia/moonshotai/kimi-k2.5` と並んで `nvidia/nvidia/nemotron-...`)。ピッカーはリテラルな `/` 構成を保持しつつ、API に送信される正規キーは単一プレフィックスのままです。 xAI Responses パスを使用します。推奨パスは SuperGrok/X Premium OAuth です。API キーも `XAI_API_KEY` または Plugin 設定経由で引き続き機能し、Grok `web_search` は API キーフォールバックの前に同じ認証プロファイルを再利用します。`grok-4.3` はバンドル済みのデフォルトチャットモデルで、`grok-build-0.1` はビルド/コーディング重視の作業向けに選択できます。`/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` で無効化できます。 ## `models.providers` 経由のプロバイダー (カスタム/base URL) **カスタム**プロバイダーまたは OpenAI/Anthropic 互換プロキシを追加するには、`models.providers` (または `models.json`) を使用します。 以下のバンドル済みプロバイダーPluginの多くは、すでにデフォルトカタログを公開しています。デフォルトのベース URL、ヘッダー、またはモデル一覧を上書きしたい場合にのみ、明示的な `models.providers.` エントリを使用してください。 Gateway のモデル機能チェックは、明示的な `models.providers..models[]` メタデータも読み取ります。カスタムモデルまたはプロキシモデルが画像を受け付ける場合は、そのモデルに `input: ["text", "image"]` を設定して、WebChat と node-origin の添付パスが画像をテキストのみのメディア参照ではなく、ネイティブなモデル入力として渡せるようにしてください。 `agents.defaults.models["provider/model"]` は、エージェント向けのモデルの表示、エイリアス、モデルごとのメタデータのみを制御します。それだけでは新しいランタイムモデルは登録されません。カスタムプロバイダーモデルの場合は、少なくとも一致する `id` を含む `models.providers..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-model-refs:start" - `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` [//]: # "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 コーディング 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 は M2.x ファミリーの thinking をデフォルトで無効にします。MiniMax-M3 (および M3.x) はデフォルトでプロバイダーの省略/適応型 thinking パスのままです。`/fast on` は `MiniMax-M2.7` を `MiniMax-M2.7-highspeed` に書き換えます。 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 のいずれかに置き換えてください)。 ```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_API_KEY` でオプトインすると、Ollama は `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 プロキシでは、送信リクエスト本文へ追加の JSON をマージするために `agents.defaults.models["provider/model"].params.extra_body` (または `extraBody`) を設定してください。 - 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 リクエスト処理が延長されますが、エージェント実行全体のタイムアウトは増えません。`agents.defaults.timeoutSeconds` または実行固有のタイムアウトの方が低い場合は、その上限も引き上げてください。プロバイダータイムアウトは実行全体を延長できません。 - モデルプロバイダーの HTTP 呼び出しは、設定されたプロバイダー `baseUrl` ホスト名に対してのみ、`198.18.0.0/15` と `fc00::/7` にある Surge、Clash、sing-box の fake-IP DNS 応答を許可します。カスタム/ローカルプロバイダーエンドポイントも、local loopback、LAN、tailnet ホストを含む保護されたモデルリクエストについて、その正確に設定された `scheme://host:port` オリジンを信頼します。これは新しい設定オプションではありません。設定した `baseUrl` は、そのオリジンに対してのみリクエストポリシーを拡張します。fake-IP ホスト名許可と正確なオリジン信頼は独立した仕組みです。その他のプライベート、local loopback、リンクローカル、メタデータ宛先、および異なるポートには、引き続き明示的な `models.providers..request.allowPrivateNetwork: true` オプトインが必要です。正確なオリジン信頼をオプトアウトするには、`models.providers..request.allowPrivateNetwork: false` を設定してください。 - `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) - プロバイダー別セットアップガイド