模型供應商

LLM／模型供應商的參考資料（非 WhatsApp／Telegram 等聊天頻道）。模型選擇規則請參閱模型。

快速規則

在控制介面中設定供應商

在控制介面中開啟 Settings → Model Providers，以新增、取代或移除儲存在 models.providers.<id>.apiKey 中的供應商 API 金鑰。此頁面會指出各 API 金鑰來自 OpenClaw 設定還是環境變數，而不會顯示認證資訊。由環境提供的金鑰仍由閘道程序環境管理。

使用 Test connection 執行即時供應商探測，並查看延遲或經分類的驗證、速率限制、帳務、逾時或回應錯誤。探測會發出實際的供應商要求，並可能耗用少量權杖。也可以從供應商卡片登出 OAuth 與權杖設定檔。

Default models 卡片可管理主要模型、依序排列的備援模型，以及設定模型目錄中的公用程式模型。選擇模型後，一併儲存至現有的 agents.defaults.model 與 agents.defaults.utilityModel 設定。對於公用程式模型，Automatic 會讓設定保持未設定，而 Disabled 則會儲存空字串，以關閉公用程式路由。

外掛擁有的供應商行為

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

供應商 SDK 掛鉤與隨附外掛範例的完整清單位於供應商外掛。需要完全自訂要求執行器的供應商屬於另一個更深層的擴充介面。

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.6；在直接 API 上，裸露的 ID 會解析為 Sol。
• 模型範例：openai/gpt-5.6、openai/gpt-5.6-terra、openai/gpt-5.6-luna、openai/gpt-5.5
• 若特定安裝或 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 相容 Proxy
• 原生 OpenAI 路由也會保留 Responses store、提示快取提示，以及 OpenAI 推理相容承載資料塑形；Proxy 路由則不會
• openai/gpt-5.3-codex-spark 僅可透過 ChatGPT／Codex OAuth 使用；直接 OpenAI API 金鑰與 Azure API 金鑰路由會拒絕它

{  agents: { defaults: { model: { primary: "openai/gpt-5.6" } } },}

若 API 組織未提供 GPT-5.6，請明確設定 openai/gpt-5.5。一般新手引導與重新驗證會保留 現有的明確主要模型；models auth login --set-default 與 models set 是刻意取代模型的途徑。

Anthropic

• 供應商：anthropic
• 驗證：ANTHROPIC_API_KEY
• 選用輪替：ANTHROPIC_API_KEYS、ANTHROPIC_API_KEY_1、ANTHROPIC_API_KEY_2，以及 OPENCLAW_LIVE_ANTHROPIC_KEY（單一覆寫）
• 模型範例：anthropic/claude-opus-5
• 命令列介面：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-5 搭配 模型範圍的 agentRuntime.id: "claude-cli"。舊版 claude-cli/claude-opus-4-7 參照仍可用於相容性。

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

OpenAI ChatGPT／Codex OAuth

• 供應商：openai
• 驗證：OAuth (ChatGPT)
• 全新原生 Codex app-server 測試框架參照：openai/gpt-5.6-sol
• 原生 Codex app-server 測試框架文件：Codex 測試框架
• 舊版模型參照：codex/gpt-*、openai-codex/gpt-*
• 外掛邊界：openai/* 會載入 OpenAI 外掛；由明確的執行階段原則或供應商擁有的有效路由決定是否選取原生 Codex app-server 外掛。
• 命令列介面：openclaw onboard --auth-choice openai 或 openclaw models auth login --provider openai
• OpenClaw 內嵌的 ChatGPT Responses 傳輸預設為 auto（優先使用 WebSocket，SSE 作為備援）。
• agents.defaults.models["openai/<model>"].params.transport、params.serviceTier 和 params.fastMode 是明確設定的內嵌請求設定。它們讓隱含的執行階段選取仍由 OpenClaw 負責；原生 Codex 則自行管理其 app-server 傳輸與服務層級。
• 隱藏的 OpenClaw 歸屬標頭（originator、version、User-Agent）只會附加至前往 chatgpt.com/backend-api 的原生 Codex 流量，不會附加至一般的 OpenAI 相容代理伺服器
• 共用的 /fast 切換選項仍可作為執行階段控制使用；它與明確設定的模型參數不同。
• 原生 Codex 目錄可依帳戶存取權限公開確切的 openai/gpt-5.6-sol、openai/gpt-5.6-terra 和 openai/gpt-5.6-luna 參照。它不會在用戶端套用直接 API 的裸 gpt-5.6 別名。
• openai/gpt-5.5 使用 Codex 目錄原生的 contextWindow = 400000 與預設執行階段 contextTokens = 272000；可使用 models.providers.openai.models[].contextTokens 覆寫執行階段上限
• 使用 openai 驗證登入，並使用 openai/gpt-5.6-sol 建立由訂閱支援的全新設定。如果該 Codex 工作區未公開 GPT-5.6，請明確選取 openai/gpt-5.5。
• 使用供應商／模型 agentRuntime.id: "openclaw"，讓原本符合資格的路由繼續使用內建執行階段。當執行階段未設定或為 auto 時，只有完全符合官方 HTTPS Responses／ChatGPT 相容格式，且沒有明確請求覆寫的路由，才能隱含選取 Codex。
• 舊版 Codex GPT 參照屬於舊版狀態，不是有效的供應商路由。新代理程式設定請使用標準 openai/* 參照，並執行 openclaw doctor --fix 來遷移 codex/* 和 openai-codex/* 參照，同時透過模型範圍的 agentRuntime.id: "codex" 保留其原生 Codex 語意。現有明確選取的標準 openai/gpt-5.5 不會升級。

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

{  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.5-flash
• 相容性：使用 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> 項目。

內建和目錄中已知的路由會從其所屬的供應商外掛取得 compat 功能。設定中的 compat 區塊適用於自訂供應商／模型，或端點合約已經過驗證的不同 api/baseUrl 路由；請參閱自訂供應商功能指南。Doctor 會移除僅重複目錄內容的舊版值，並保留相異的值供操作人員檢閱。

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

agents.defaults.models["provider/model"] 控制代理程式的別名和個別模型中繼資料。它本身既不限制覆寫，也不註冊新的執行階段模型。對於自訂供應商模型，也請新增 models.providers.<provider>.models[]，並至少包含相符的 id；若要限制覆寫，請另行使用 agents.defaults.modelPolicy.allow。

Moonshot AI（Kimi）

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

• 供應商：moonshot
• 驗證：MOONSHOT_API_KEY
• 範例模型：moonshot/kimi-k3
• 命令列介面：openclaw onboard --auth-choice moonshot-api-key 或 openclaw onboard --auth-choice moonshot-api-key-cn

Kimi 模型 ID：

• moonshot/kimi-k2.6
• moonshot/kimi-k3
• moonshot/kimi-k2.7-code
• moonshot/kimi-k2.7-code-highspeed
• moonshot/kimi-k2.5

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

完整設定指南請參閱 Moonshot AI（Kimi + Kimi Coding）。

Kimi Coding

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

• 供應商：kimi
• 驗證：KIMI_API_KEY
• Kimi K3：kimi/k3（256K）或 kimi/k3[1m]（1M 方案）
• Kimi Code：kimi/kimi-for-coding
• Kimi Code HighSpeed：kimi/kimi-for-coding-highspeed

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

舊版 kimi/kimi-code 和 kimi/k2p5 仍可作為相容性模型 ID 使用，並會正規化為 Kimi 的穩定 API 模型 ID。

Volcano Engine（豆包）

Volcano Engine（火山引擎）在中國提供豆包和其他模型的存取服務。

• 供應商：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-M3
• 命令列介面：openclaw onboard --auth-choice synthetic-api-key

{  agents: {    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M3" } },  },  models: {    mode: "merge",    providers: {      synthetic: {        baseUrl: "https://api.synthetic.new/anthropic",        apiKey: "${SYNTHETIC_API_KEY}",        api: "anthropic-messages",        models: [{ id: "hf:MiniMaxAI/MiniMax-M3", name: "MiniMax M3" }],      },    },  },}

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_API_KEY 用於 minimax；MINIMAX_OAUTH_TOKEN 或 MINIMAX_API_KEY 用於 minimax-portal

如需設定詳細資訊、模型選項和配置片段，請參閱 /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 的即時載入、TTL 和自動逐出功能管理模型生命週期，請設定 models.providers.lmstudio.params.preload: false。如需設定與疑難排解，請參閱 /providers/lmstudio。

Ollama

Ollama 以內建提供者外掛形式提供，並使用 Ollama 的原生 API：

• 提供者：ollama
• 驗證：不需要（本機伺服器）
• 模型範例：ollama/llama3.3
• 安裝：https://ollama.com/download

# 安裝 Ollama，然後拉取模型：ollama pull llama3.3

{  agents: {    defaults: { model: { primary: "ollama/llama3.3" } },  },}

使用 OLLAMA_API_KEY 選擇啟用後，系統會在本機的 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

另請參閱：配置，其中提供完整的配置範例。

相關內容

• 配置參考 - 模型配置鍵
• 模型容錯移轉 - 備援鏈與重試行為
• 模型 - 模型配置與別名
• 提供者 - 各提供者的設定指南