模型供應商

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

快速規則

在控制介面中設定供應商

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

使用測試連線執行即時供應商探測，並查看延遲，或已分類的驗證、速率限制、計費、逾時或回應錯誤。探測會向供應商發出真實要求，並可能消耗少量權杖。也可以從供應商卡片登出 OAuth 和權杖設定檔。

預設模型卡片會透過已設定的模型目錄管理主要模型、依序排列的備援模型及公用模型。選擇模型後，將它們一併儲存至現有的 agents.defaults.model 和 agents.defaults.utilityModel 設定。對於公用模型，自動會讓設定保持未設定，而停用會儲存空字串以關閉公用模型路由。

外掛擁有的供應商行為

大多數供應商特定邏輯位於供應商外掛（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 相容代理伺服器
• 原生 OpenAI 路由也會保留 Responses store、提示快取提示及 OpenAI 推理相容承載資料塑形；代理伺服器路由則不會
• 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-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）
• 全新原生 Codex app-server 測試框架參照：openai/gpt-5.6-sol
• 原生 Codex app-server 測試框架文件：Codex 測試框架
• 舊版模型參照：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 相容 Proxy
• 共用的 /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/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 閘道

• 供應商：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。只有在需要覆寫基礎 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" }],      },    },  },}

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

Kimi Coding

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 的即時載入、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

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

相關內容

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