モデルプロバイダー

​

クイックルール

​

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

​

API キーのローテーション

​

公式プロバイダー Plugin

​

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/<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 トグルではなく明示的な tier が必要な場合は、params.serviceTier を使用します。
• 非表示の OpenClaw attribution ヘッダー（originator、version、User-Agent）は、api.openai.com へのネイティブ OpenAI トラフィックにのみ適用され、汎用 OpenAI 互換プロキシには適用されません。
• ネイティブ OpenAI ルートは Responses の store、プロンプトキャッシュヒント、OpenAI reasoning 互換ペイロード整形も保持します。プロキシルートは保持しません。
• openai/gpt-5.3-codex-spark は ChatGPT/Codex OAuth 経由でのみ利用できます。直接の OpenAI API キーと Azure API キールートでは拒否されます。

{
  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-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.5
• ネイティブ Codex app-server ハーネスのドキュメント: Codex ハーネス
• レガシーモデル参照: 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 フォールバック）です。
• OpenAI Codex モデルごとの上書きは agents.defaults.models["openai/<model>"].params.transport（"sse"、"websocket"、または "auto"）で行います。
• params.serviceTier はネイティブ Codex Responses リクエスト（chatgpt.com/backend-api）にも転送されます。
• 非表示の OpenClaw attribution ヘッダー（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 で上書きします。
• 標準サブスクリプションとネイティブ Codex ランタイムルートには、openai 認証でサインインし、openai/gpt-5.5 を設定します。OpenAI エージェントターンはデフォルトで Codex を選択します。
• 組み込み OpenClaw ルートが必要な場合にのみ、プロバイダー/モデルの agentRuntime.id: "openclaw" を使用します。それ以外の場合は、openai/gpt-5.5 をデフォルトの Codex ハーネスのままにします。
• レガシー Codex GPT 参照はレガシー状態であり、ライブプロバイダールートではありません。新しいエージェント設定ではネイティブ Codex ランタイム上の openai/gpt-5.5 を使用し、古いレガシー Codex モデル参照を正規の openai/* 参照に移行するには openclaw doctor --fix を実行してください。

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

{
  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-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 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 フローを使用する

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

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

​

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）

​

Moonshot AI (Kimi)

• プロバイダー: moonshot
• 認証: MOONSHOT_API_KEY
• サンプルモデル: moonshot/kimi-k2.6
• CLI: openclaw onboard --auth-choice moonshot-api-key または openclaw onboard --auth-choice moonshot-api-key-cn

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

​

Kimi Coding

• プロバイダー: kimi
• 認証: KIMI_API_KEY
• サンプルモデル: kimi/kimi-for-coding

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

​

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

​

BytePlus (International)

• プロバイダー: 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" } },
  },
}

​

Synthetic

• プロバイダー: 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 OAuth (グローバル): --auth-choice minimax-global-oauth
• MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
• MiniMax APIキー (グローバル): --auth-choice minimax-global-api
• MiniMax APIキー (CN): --auth-choice minimax-cn-api
• 認証: minimax 用は MINIMAX_API_KEY; minimax-portal 用は MINIMAX_OAUTH_TOKEN または MINIMAX_API_KEY

• テキスト/チャットのデフォルトは minimax/MiniMax-M3 のままです
• 画像生成は minimax/image-01 または minimax-portal/image-01 です
• 画像理解は、両方の MiniMax 認証パスで Plugin所有の MiniMax-VL-01 です
• Web検索はプロバイダーID minimax のままです

​

LM Studio

• プロバイダー: lmstudio
• 認証: LM_API_TOKEN
• デフォルトの推論ベースURL: http://localhost:1234/v1

{
  agents: {
    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },
  },
}

​

Ollama

• プロバイダー: 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" } },
  },
}

​

vLLM

• プロバイダー: vllm
• 認証: 任意 (サーバーによります)
• デフォルトのベースURL: http://127.0.0.1:8000/v1

export VLLM_API_KEY="vllm-local"

{
  agents: {
    defaults: { model: { primary: "vllm/your-model-id" } },
  },
}

​

SGLang

• プロバイダー: sglang
• 認証: 任意 (サーバーによります)
• デフォルトのベースURL: http://127.0.0.1:30000/v1

export SGLANG_API_KEY="sglang-local"

{
  agents: {
    defaults: { model: { primary: "sglang/your-model-id" } },
  },
}

​

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

{
  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

​

関連

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