モデルプロバイダー

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

# 簡単なルール

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

プロバイダー固有のロジックの大半は Provider Plugin（registerProvider(...)）内にあり、OpenClaw は汎用の推論ループを保持します。Plugin はオンボーディング、モデルカタログ、認証 env-var マッピング、transport/config 正規化、ツールスキーマのクリーンアップ、フェイルオーバー分類、OAuth 更新、使用量レポート、thinking/reasoning プロファイルなどを所有します。

Provider SDK フックとバンドル Plugin の例の完全な一覧は、Provider plugins にあります。完全にカスタムのリクエスト実行器が必要なプロバイダーは、別のより深い拡張サーフェスです。

# API キーのローテーション

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

OpenClaw には pi-ai カタログが同梱されています。これらのプロバイダーには models.providers config は不要です。認証を設定し、モデルを選ぶだけです。

# 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
• デフォルト transport は auto（WebSocket 優先、SSE フォールバック）です
• モデルごとの上書きは agents.defaults.models["openai/<model>"].params.transport（"sse"、"websocket"、または "auto"）で行います
• OpenAI Responses WebSocket ウォームアップは、params.openaiWsWarmup（true/false）によりデフォルトで有効です
• OpenAI 優先処理は agents.defaults.models["openai/<model>"].params.serviceTier で有効にできます
• /fast と params.fastMode は、直接 openai/* Responses リクエストを api.openai.com 上の service_tier=priority にマップします
• 共有の /fast トグルではなく明示的な tier が必要な場合は params.serviceTier を使用します
• 非表示の OpenClaw 帰属ヘッダー（originator、version、User-Agent）は、api.openai.com へのネイティブ OpenAI トラフィックにのみ適用され、汎用 OpenAI 互換プロキシには適用されません
• ネイティブ OpenAI ルートは Responses の store、プロンプトキャッシュヒント、OpenAI reasoning 互換のペイロード整形も維持します。プロキシルートは維持しません
• openai/gpt-5.3-codex-spark は OpenClaw で意図的に抑制されています。ライブの OpenAI API リクエストがこれを拒否し、現在の Codex カタログでも公開されていないためです

{
  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 config は、モデル参照を正規のまま保ち、CLI バックエンドを別に選択します。つまり agents.defaults.agentRuntime.id: "claude-cli" と組み合わせた anthropic/claude-opus-4-7 です。レガシーの claude-cli/claude-opus-4-7 参照も互換性のため引き続き動作します。

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

# OpenAI Codex OAuth

• プロバイダー: openai-codex
• 認証: OAuth（ChatGPT）
• PI モデル参照: openai-codex/gpt-5.5
• ネイティブ Codex アプリサーバーハーネス参照: agents.defaults.agentRuntime.id: "codex" と組み合わせた openai/gpt-5.5
• ネイティブ Codex アプリサーバーハーネスの docs: Codex harness
• レガシーモデル参照: codex/gpt-*
• Plugin 境界: openai-codex/* は OpenAI Plugin をロードします。ネイティブ Codex アプリサーバー Plugin は、Codex harness runtime またはレガシーの codex/* 参照によってのみ選択されます。
• CLI: openclaw onboard --auth-choice openai-codex または openclaw models auth login --provider openai-codex
• デフォルト transport は 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 config を共有します。OpenClaw はそれを service_tier=priority にマップします
• openai-codex/gpt-5.5 は Codex カタログネイティブの contextWindow = 400000 とデフォルト runtime contextTokens = 272000 を使用します。runtime 上限は models.providers.openai-codex.models[].contextTokens で上書きします
• ポリシー注記: OpenAI Codex OAuth は、OpenClaw のような外部ツール/ワークフローに対して明示的にサポートされています。
• 一般的なサブスクリプションとネイティブ Codex runtime のルートでは、openai-codex 認証でサインインし、openai/gpt-5.5 と agents.defaults.agentRuntime.id: "codex" を組み合わせて設定してください。
• openai-codex/gpt-5.5 は、PI 経由の Codex OAuth/サブスクリプションルートが必要な場合にのみ使用してください。API キー構成とローカルカタログが公開 API ルートを公開している場合は、Codex runtime 上書きなしの openai/gpt-5.5 を使用してください。
• 古い openai-codex/gpt-5.1*、openai-codex/gpt-5.2*、openai-codex/gpt-5.3* 参照は、ChatGPT/Codex OAuth アカウントが拒否するため抑制されています。代わりに openai-codex/gpt-5.5 またはネイティブ Codex runtime ルートを使用してください。

{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.5" },
      agentRuntime: { id: "codex" },
    },
  },
}

{
  models: {
    providers: {
      "openai-codex": {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

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

# OpenCode

• 認証: OPENCODE_API_KEY（または OPENCODE_ZEN_API_KEY）
• Zen runtime プロバイダー: opencode
• Go runtime プロバイダー: 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
• Thinking: /think adaptive は Google dynamic thinking を使用します。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 の 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

# 知っておくとよい癖

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

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

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

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

# 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-code

{
  env: { KIMI_API_KEY: "sk-..." },
  agents: {
    defaults: { model: { primary: "kimi/kimi-code" } },
  },
}

従来の kimi/k2p5 は互換性モデル 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 (International)

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 (Global): --auth-choice minimax-global-oauth
• MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
• MiniMax API key (Global): --auth-choice minimax-global-api
• MiniMax API key (CN): --auth-choice minimax-cn-api
• 認証: minimax には MINIMAX_API_KEY; minimax-portal には MINIMAX_OAUTH_TOKEN または MINIMAX_API_KEY

セットアップの詳細、モデルオプション、設定スニペットについては /providers/minimax を参照してください。

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_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-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

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

# 関連

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