模型供應商

LLM/模型提供者（不是 WhatsApp/Telegram 這類聊天頻道）的參考。模型選擇規則請參閱模型。

快速規則

外掛擁有的提供者行為

大多數提供者特定邏輯位於提供者外掛（registerProvider(...)）中，而 OpenClaw 保留通用推論迴圈。外掛負責上線導引、模型目錄、驗證環境變數對應、傳輸/設定正規化、工具結構描述清理、容錯移轉分類、OAuth 重新整理、用量回報、思考/推理設定檔等。

提供者 SDK hook 與內建外掛範例的完整清單位於提供者外掛。需要完全自訂請求執行器的提供者，屬於另一個更深入的擴充介面。

API 金鑰輪替

官方提供者外掛

官方提供者外掛會發布自己的模型目錄列。這些提供者不需要任何 models.providers 模型項目；啟用提供者外掛、設定驗證，然後選擇模型即可。只有在明確自訂提供者或逾時等窄範圍請求設定時，才使用 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 驗證帳戶/模型可用性。
• 命令列介面：openclaw onboard --auth-choice openai-api-key
• 預設傳輸為 auto；OpenClaw 會將傳輸選擇傳遞給共用模型執行階段。
• 透過 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 時，可透過 ChatGPT/Codex OAuth 訂閱驗證使用它；OpenClaw 仍會抑制此模型的直接 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
• 命令列介面：openclaw onboard --auth-choice apiKey
• 直接的公開 Anthropic 請求支援共用 /fast 切換和 params.fastMode，包括傳送到 api.anthropic.com 的 API 金鑰與 OAuth 驗證流量；OpenClaw 會將其對應到 Anthropic service_tier（auto 與 standard_only）
• 偏好的 Claude 命令列介面設定會讓模型參照保持標準，並另行選擇命令列介面 後端：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）
• 舊版 OpenAI Codex 模型參照：openai/gpt-5.5
• 原生 Codex app-server harness 參照：openai/gpt-5.5
• 原生 Codex app-server harness 文件：Codex harness
• 舊版模型參照：codex/gpt-*
• 外掛邊界：openai/* 會載入 OpenAI 外掛；原生 Codex app-server 外掛由 Codex harness 執行階段選取。
• 命令列介面：openclaw onboard --auth-choice openai 或 openclaw models auth login --provider openai
• 預設傳輸為 auto（WebSocket 優先，SSE 備援）
• 透過 agents.defaults.models["openai/<model>"].params.transport 針對每個 OpenAI Codex 模型覆寫（"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/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 harness 上。
• 舊版 Codex GPT 參照是舊版狀態，不是即時提供者路由。新的代理設定請在原生 Codex 執行階段上使用 openai/gpt-5.5，並執行 openclaw doctor --fix 將舊的舊版 Codex 模型參照遷移到標準 openai/* 參照。

{  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
• 命令列介面：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
• 命令列介面：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 流程

Gemini CLI OAuth 會作為內建 google 外掛的一部分提供。

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 預設使用 stream-json。OpenClaw 會讀取助理串流 訊息，並將 stats.cached 正規化為 cacheRead；舊版 --output-format json 覆寫仍會從 response 讀取回覆文字。

Z.AI (GLM)

• 提供者：zai
• 驗證：ZAI_API_KEY
• 範例模型：zai/glm-5.2
• 命令列介面：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
• 命令列介面：openclaw onboard --auth-choice ai-gateway-api-key

其他內建提供者外掛

值得了解的特性

透過 models.providers 使用提供者（自訂／基底 URL）

使用 models.providers（或 models.json）新增自訂提供者或 OpenAI/Anthropic 相容代理。

以下許多隨附的提供者外掛已經發布預設目錄。只有在你想覆寫預設基礎 URL、標頭或模型清單時，才使用明確的 models.providers.<id> 項目。

閘道模型能力檢查也會讀取明確的 models.providers.<id>.models[] 中繼資料。如果自訂或代理模型接受圖片，請在該模型上設定 input: ["text", "image"]，讓 WebChat 和節點來源的附件路徑將圖片作為原生模型輸入傳遞，而不是純文字媒體參照。

agents.defaults.models["provider/model"] 只控制代理程式的模型可見性、別名和個別模型中繼資料。它本身不會註冊新的執行階段模型。若是自訂提供者模型，也請新增 models.providers.<provider>.models[]，其中至少要有相符的 id。

Moonshot AI (Kimi)

請先安裝 @openclaw/moonshot-provider 再進行 onboarding。只有在需要覆寫基礎 URL 或模型中繼資料時，才新增明確的 models.providers.moonshot 項目：

• 提供者：moonshot
• 驗證：MOONSHOT_API_KEY
• 範例模型：moonshot/kimi-k2.6
• 命令列介面：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.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 程式碼撰寫

Kimi Coding 使用 Moonshot AI 的 Anthropic 相容端點：

• 提供者：kimi
• 驗證：KIMI_API_KEY
• 範例模型：kimi/kimi-for-coding

{  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
• 命令列介面：openclaw onboard --auth-choice volcengine-api-key

{  agents: {    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },  },}

入門設定預設使用編碼介面，但同時也會註冊一般的 volcengine/* 目錄。

在入門設定/設定模型選擇器中，Volcengine 驗證選項會優先使用 volcengine/* 和 volcengine-plan/* 列。如果這些模型尚未載入，OpenClaw 會改用未篩選的目錄，而不是顯示空的供應商範圍選擇器。

BytePlus（國際）

BytePlus ARK 為國際使用者提供與 Volcano Engine 相同模型的存取權。

• 供應商：byteplus（編碼：byteplus-plan）
• 驗證：BYTEPLUS_API_KEY
• 範例模型：byteplus-plan/ark-code-latest
• 命令列介面：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
• 命令列介面：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（全球）：--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，了解設定詳細資料、模型選項和設定片段。

外掛擁有的能力拆分：

• 文字/聊天預設維持在 minimax/MiniMax-M3
• 圖像生成為 minimax/image-01 或 minimax-portal/image-01
• 圖像理解是在兩條 MiniMax 驗證路徑上都由外掛擁有的 MiniMax-VL-01
• 網頁搜尋維持使用供應商 ID minimax

LM Studio

LM Studio 以使用原生 API 的內建供應商外掛形式提供：

• 供應商：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 以內建供應商外掛形式提供，並使用 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 選擇啟用時，OpenClaw 會在本機 http://127.0.0.1:11434 偵測 Ollama，而內建供應商外掛會將 Ollama 直接加入 openclaw onboard 和模型選擇器。請參閱 /providers/ollama 了解入門設定、雲端/本機模式和自訂設定。

vLLM

vLLM 以內建供應商外掛形式提供，用於本機/自行託管的 OpenAI 相容伺服器：

• 供應商：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 相容伺服器：

• 供應商：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,          },        ],      },    },  },}

命令列介面範例

openclaw onboard --auth-choice opencode-zenopenclaw models set opencode/claude-opus-4-6openclaw models list

另請參閱：設定，取得完整設定範例。

相關

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