模型供應商

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

快速規則

​

Plugin 擁有的提供者行為

​

API 金鑰輪替

​

內建提供者（pi-ai 目錄）

​

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"）
• 可透過 agents.defaults.models["openai/<model>"].params.serviceTier 啟用 OpenAI 優先處理
• /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 在 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 設定會保留標準模型參照，並另外選擇 CLI 後端：anthropic/claude-opus-4-7 搭配 模型範圍的 agentRuntime.id: "claude-cli"。舊版 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 應用程式伺服器 harness 參照：openai/gpt-5.5
• 原生 Codex 應用程式伺服器 harness 文件：Codex harness
• 舊版模型參照：codex/gpt-*
• Plugin 邊界：openai-codex/* 會載入 OpenAI Plugin；原生 Codex 應用程式伺服器 Plugin 只會由 Codex harness 執行階段或舊版 codex/* 參照選取。
• CLI：openclaw onboard --auth-choice openai-codex 或 openclaw models auth login --provider openai-codex
• 預設傳輸為 auto（WebSocket 優先，SSE 備援）
• 透過 agents.defaults.models["openai-codex/<model>"].params.transport 針對每個 PI 模型覆寫（"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 harness 上。
• 舊版 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 }],
      },
    },
  },
}

​

其他訂閱式託管選項

​

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 也接受 agents.defaults.models["google/<model>"].params.cachedContent（或舊版 cached_content），以轉送提供者原生的 cachedContents/... 控制代碼；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.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 中。

​

其他內建提供者 Plugin

​

值得知道的特殊事項

​

透過 models.providers 的供應商（自訂/基底 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.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（coding：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（國際）

• 供應商：byteplus（coding：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（中國）：--auth-choice minimax-cn-oauth
• MiniMax API 金鑰（全球）：--auth-choice minimax-global-api
• MiniMax API 金鑰（中國）：--auth-choice minimax-cn-api
• 驗證：MINIMAX_API_KEY 用於 minimax；MINIMAX_OAUTH_TOKEN 或 MINIMAX_API_KEY 用於 minimax-portal

• 文字/聊天預設保留在 minimax/MiniMax-M2.7
• 圖像生成是 minimax/image-01 或 minimax-portal/image-01
• 圖像理解是在兩條 MiniMax 驗證路徑上由 Plugin 擁有的 MiniMax-VL-01
• 網頁搜尋保留在供應商 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

​

相關

• 設定參考 - 模型設定鍵
• 模型容錯移轉 - 後援鏈和重試行為
• 模型 - 模型設定和別名
• 供應商 - 各供應商設定指南