Skip to content
OpenClaw Docs

模型供應商

LLM/模型提供商參考資料（不包括 WhatsApp/Telegram 等聊天頻道）。關於模型選擇規則，請參閱 Models。

快速規則

Section titled “快速規則”
Model refs and CLI helpers
  • 模型引用使用 provider/model（例如：opencode/claude-opus-4-6）。
  • agents.defaults.models 在設定時充許允許清單。
  • CLI 輔助工具：openclaw onboard、openclaw models list、`openclaw models set

。 - models.providers..contextWindow/contextTokens/maxTokens 設定供應商層級的預設值；models.providers..models[].contextWindow/contextTokens/maxTokens` 會針對每個模型進行覆寫。 - 關於容錯規則、冷卻探測和會話覆寫持續性：Model failover。

Adding provider auth does not change your primary model

當您新增或重新驗證提供者時，openclaw configure 會保留現有的 agents.defaults.model.primary。openclaw models auth login 也有相同作用，除非您傳遞了 --set-default。提供者外掛程式可能仍會在其授權設定修補中返回建議的預設模型，但當主要模型已存在時，OpenClaw 會將其視為「讓此模型可用」，而非「取代目前的主要模型」。

若要刻意切換預設模型，請使用 `openclaw models set

或openclaw models auth login —provider

—set-default`。

OpenAI provider/runtime split

OpenAI 系列的路由是基於前綴區分的：

  • `openai/

預設會針對代理回合使用原生的 Codex app-server harness。這是常見的 ChatGPT/Codex 訂閱設定。 -openai-codex/

是舊版設定，doctor 會將其重寫為openai/

。 - openai/

加上供應商/模型agentRuntime.id: “pi”` 會使用 PI 來處理明確的 API 金鑰或相容路由。

請參閱 [OpenAI](/zh-Hant/providers/openai) 和 [Codex harness](/zh-Hant/plugins/codex-harness)。如果供應商/運行時的區分讓您感到困惑，請先閱讀 [Agent runtimes](/zh-Hant/concepts/agent-runtimes)。


外掛程式自動啟用遵循相同的邊界：`openai/*` 代理引用會為預設路由啟用 Codex 外掛程式，而明確的供應商/模型 `agentRuntime.id: "codex"` 或舊版 `codex/

` 引用也需要它。

GPT-5.5 預設可透過 `openai/gpt-5.5` 上的原生 Codex app-server harness 取得，且僅在供應商/模型運行時原則明確選擇 `pi` 時透過 PI 取得。
CLI runtimes

CLI 執行階段使用相同的拆分：選擇標準模型引用，例如 anthropic/claude-* 或 google/gemini-*，然後在您需要本機 CLI 後端時，將提供者/模型執行階段原則設定為 claude-cli 或 google-gemini-cli。

舊版 claude-cli/* 和 google-gemini-cli/* 引用會遷移回標準提供者引用，並單獨記錄執行階段。舊版 codex-cli/* 引用會遷移至 openai/* 並使用 Codex 應用伺服器路由；OpenClaw 不再維護捆綁的 Codex CLI 後端。

外掛程式擁有的提供者行為

Section titled “外掛程式擁有的提供者行為”

大多數特定於提供者的邏輯位於提供者外掛 (registerProvider(...)) 中，而 OpenClaw 則保留通用推論迴圈。外掛負責上架、模型目錄、授權環境變數對應、傳輸/配置標準化、工具架構清理、故障轉移分類、OAuth 重新整理、使用情況報告、思考/推理設定檔等。

提供商 SDK hooks 和捆綁外掛程式範例的完整清單位於 Provider plugins。需要完全自訂請求執行器的提供商是一個獨立的、更深入的擴充介面。

API 金鑰輪替

Section titled “API 金鑰輪替”
Key sources and priority

透過以下方式配置多個金鑰：

  • `OPENCLAW_LIVE_

_KEY(單一即時覆寫，優先順序最高) -

_API_KEYS(逗號或分號清單) -

_API_KEY(主金鑰) -

API_KEY*(編號清單，例如

_API_KEY_1`)

對於 Google 提供者，`GOOGLE_API_KEY` 也會作為後備包含在內。金鑰選擇順序會保留優先順序並將值去重。
When rotation kicks in
  • 僅在遇到速率限制回應時（例如 429、rate_limit、quota、resource exhausted、Too many concurrent requests、ThrottlingException、concurrency limit reached、workers_ai ... quota limit exceeded 或週期性使用限制訊息），才會使用下一個金鑰重試請求。
  • 非速率限制的失敗會立即回報錯誤；不會嘗試輪換金鑰。
  • 當所有候選金鑰都失敗時，將會傳回最後一次嘗試的最終錯誤。

內建供應商 (pi-ai 目錄)

Section titled “內建供應商 (pi-ai 目錄)”

OpenClaw 內建 pi-ai catalog。這些供應商不需要 models.providers 設定；只需設定驗證並選擇模型即可。

OpenAI

Section titled “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 要求對應到 service_tier=priority 上的 api.openai.com
  • 當您想要明確的層級而不是共用的 /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

Section titled “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 vs 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

Section titled “OpenAI Codex OAuth”
  • 供應商：openai-codex
  • 驗證：OAuth (ChatGPT)
  • 舊版 PI 模型引用：openai-codex/gpt-5.5
  • 原生 Codex 應用程式伺服器套件引用：openai/gpt-5.5
  • 原生 Codex 應用程式伺服器 harness 文件：Codex harness
  • 舊版模型參考：codex/gpt-*
  • 插件邊界：openai-codex/* 會載入 OpenAI 插件；原生的 Codex app-server 插件僅由 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 的相容性路由時，才使用 provider/model agentRuntime.id: "pi"；否則請將 openai/gpt-5.5 保持在預設的 Codex harness 上。
  • openai-codex/gpt-* 參考仍為傳統 PI 路由。對於新的代理程式組態，請在原生 Codex 執行時間上優先使用 openai/gpt-5.5，並在您想要將舊的 openai-codex/* 參考遷移至標準 openai/* 參考時執行 openclaw doctor --fix。
{
  plugins: { entries: { codex: { enabled: true } } },
  agents: {
    defaults: {
      model: { primary: "openai/gpt-5.5" },
    },
  },
}
{
  models: {
    providers: {
      "openai-codex": {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

其他訂閱式託管選項

Section titled “其他訂閱式託管選項”
GLM 模型

Z.AI Coding Plan 或一般 API 端點。

MiniMax

MiniMax Coding Plan OAuth 或 API 金鑰存取。

Qwen Cloud

Qwen Cloud 提供者介面，以及 Alibaba DashScope 和 Coding Plan 端點對應。

OpenCode

Section titled “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 金鑰)

Section titled “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

Section titled “Google Vertex 和 Gemini CLI”
  • 提供者：google-vertex、google-gemini-cli
  • 驗證：Vertex 使用 gcloud ADC；Gemini CLI 使用其 OAuth 流程

Gemini CLI OAuth 是內建 google 外掛程式的一部分。

  1. 安裝 Gemini CLI

    Terminal window
    brew install gemini-cli

  2. Enable plugin

    Terminal window
    openclaw plugins enable google

  3. 登入

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

    預設模型：google-gemini-cli/gemini-3-flash-preview。您不需要將用戶端 ID 或密鑰貼入 openclaw.json。CLI 登入流程會將權杖儲存在閘道主機上的驗證設定檔中。

  4. 設定專案（如需要）

    如果登入後請求失敗，請在閘道主機上設定 GOOGLE_CLOUD_PROJECT 或 GOOGLE_CLOUD_PROJECT_ID。

Gemini CLI JSON 回覆會從 response 解析；使用量會回退到 stats，其中 stats.cached 會被正規化為 OpenClaw cacheRead。

Z.AI (GLM)

Section titled “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

Section titled “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

Section titled “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 中硬編碼。

請參閱 /providers/kilocode 以了解設定細節。

其他內建提供者外掛

Section titled “其他內建提供者外掛”
提供者ID驗證環境變數範例模型
BytePlusbyteplus / byteplus-planBYTEPLUS_API_KEYbyteplus-plan/ark-code-latest
CerebrascerebrasCEREBRAS_API_KEYcerebras/zai-glm-4.7
Cloudflare AI Gatewaycloudflare-ai-gatewayCLOUDFLARE_AI_GATEWAY_API_KEY-
DeepInfradeepinfraDEEPINFRA_API_KEYdeepinfra/deepseek-ai/DeepSeek-V3.2
DeepSeekdeepseekDEEPSEEK_API_KEYdeepseek/deepseek-v4-flash
GitHub Copilotgithub-copilotCOPILOT_GITHUB_TOKEN / GH_TOKEN / GITHUB_TOKEN-
GroqgroqGROQ_API_KEY-
Hugging Face InferencehuggingfaceHUGGINGFACE_HUB_TOKEN 或 HF_TOKENhuggingface/deepseek-ai/DeepSeek-R1
Kilo GatewaykilocodeKILOCODE_API_KEYkilocode/kilo/auto
Kimi CodingkimiKIMI_API_KEY 或 KIMICODE_API_KEYkimi/kimi-for-coding
MiniMaxminimax / minimax-portalMINIMAX_API_KEY / MINIMAX_OAUTH_TOKENminimax/MiniMax-M2.7
MistralmistralMISTRAL_API_KEYmistral/mistral-large-latest
MoonshotmoonshotMOONSHOT_API_KEYmoonshot/kimi-k2.6
NVIDIAnvidiaNVIDIA_API_KEYnvidia/nvidia/nemotron-3-super-120b-a12b
OpenRouteropenrouterOPENROUTER_API_KEYopenrouter/auto
QianfanqianfanQIANFAN_API_KEYqianfan/deepseek-v3.2
Qwen CloudqwenQWEN_API_KEY / MODELSTUDIO_API_KEY / DASHSCOPE_API_KEYqwen/qwen3.5-plus
StepFunstepfun / stepfun-planSTEPFUN_API_KEYstepfun/step-3.5-flash
TogethertogetherTOGETHER_API_KEYtogether/moonshotai/Kimi-K2.5
VeniceveniceVENICE_API_KEY-
Vercel AI Gatewayvercel-ai-gatewayAI_GATEWAY_API_KEYvercel-ai-gateway/anthropic/claude-opus-4.6
火山引擎 (豆包)volcengine / volcengine-planVOLCANO_ENGINE_API_KEYvolcengine-plan/ark-code-latest
xAIxaiSuperGrok/X Premium OAuth 或 XAI_API_KEYxai/grok-4.3
小米xiaomiXIAOMI_API_KEYxiaomi/mimo-v2-flash

值得注意的特性

Section titled “值得注意的特性”
OpenRouter

僅在已驗證的 openrouter.ai 路由上套用其應用程式歸因標頭和 Anthropic cache_control 標記。DeepSeek、Moonshot 和 ZAI 引用符合 OpenRouter 管理的提示詞快取的快取 TTL 資格，但不會收到 Anthropic 快取標記。作為代理式 OpenAI 相容路徑，它會跳過僅限原生 OpenAI 的塑型（serviceTier、Responses store、提示詞快取提示、OpenAI 推理相容性）。備受 Gemini 支援的引用僅保留代理 Gemini 思維簽章清理功能。

Kilo Gateway

Gemini 支援的參照遵循相同的 proxy-Gemini 清理路徑；kilocode/kilo/auto 和其他不支援 proxy 推理的參照會跳過 proxy 推理注入。

MiniMax

API 金鑰導入會寫入明確的僅文字 M2.7 聊天模型定義；圖像理解保留在外掛程式擁有的 MiniMax-VL-01 媒體提供者上。

NVIDIA

模型 ID 使用 `nvidia/

/

命名空間（例如nvidia/nvidia/nemotron-…以及nvidia/moonshotai/kimi-k2.5）；選擇器會保留字面的

/

` 組成，而發送到 API 的標準金鑰則保持單一字首。

xAI

使用 xAI Responses 路徑。建議的路徑是 SuperGrok/X Premium OAuth；API 金鑰仍然可以透過 XAI_API_KEY 或外掛程式設定運作。grok-4.3 是捆綁的預設聊天模型。/fast 或 params.fastMode: true 會將 grok-3、grok-3-mini、grok-4 和 grok-4-0709 重寫為其 *-fast 變體。tool_stream 預設為開啟；請透過 `agents.defaults.models[“xai/

“].params.tool_stream=false` 停用。

Cerebras

作為捆綁的 cerebras 提供商外掛程式提供。GLM 使用 zai-glm-4.7；OpenAI 相容的基礎 URL 是 https://api.cerebras.ai/v1。

透過 models.providers 的提供商 (自訂/基礎 URL)

Section titled “透過 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)

Section titled “Moonshot AI (Kimi)”

Moonshot 作為捆綁的提供商外掛程式提供。預設情況下請使用內建提供商，並且僅在您需要覆寫基礎 URL 或模型元數據時才新增明確的 models.providers.moonshot 項目：

  • 提供商：moonshot
  • 驗證：MOONSHOT_API_KEY
  • 範例模型：moonshot/kimi-k2.6
  • CLI：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.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 程式設計

Section titled “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。

火山引擎 (Doubao)

Section titled “火山引擎 (Doubao)”

火山引擎 (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" } },
  },
}

上線預設為程式設計介面，但同時也會註冊一般的 volcengine/* 型錄。

在上線/設定模型選擇器中，Volcengine 驗證選項偏好同時顯示 volcengine/* 和 volcengine-plan/* 列。如果這些模型尚未載入，OpenClaw 將回退到未過濾的型錄，而不是顯示空的提供商範圍選擇器。

  • volcengine/doubao-seed-1-8-251228 (Doubao Seed 1.8)
  • volcengine/doubao-seed-code-preview-251028
  • volcengine/kimi-k2-5-260127 (Kimi K2.5)
  • volcengine/glm-4-7-251222 (GLM 4.7)
  • volcengine/deepseek-v3-2-251201 (DeepSeek V3.2 128K)

BytePlus (國際版)

Section titled “BytePlus (國際版)”

BytePlus ARK 為國際用戶提供與火山引擎相同的模型存取權。

  • 提供商：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" } },
  },
}

入門預設為程式編寫介面，但同時也會註冊一般 byteplus/* 目錄。

在入門/配置模型選擇器中，BytePlus 驗證選項會優先顯示 byteplus/* 和 byteplus-plan/* 列。如果這些模型尚未載入，OpenClaw 會改用未過濾的目錄，而不會顯示空的提供商範圍選擇器。

  • byteplus/seed-1-8-251228 (Seed 1.8)
  • byteplus/kimi-k2-5-260127 (Kimi K2.5)
  • byteplus/glm-4-7-251222 (GLM 4.7)

Synthetic

Section titled “Synthetic”

Synthetic 在 synthetic 提供商之後提供 Anthropic 相容模型：

  • 提供商：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

Section titled “MiniMax”

MiniMax 是透過 models.providers 配置的，因為它使用自訂端點：

  • MiniMax OAuth (Global): --auth-choice minimax-global-oauth
  • MiniMax OAuth (CN): --auth-choice minimax-cn-oauth
  • MiniMax API key (Global): --auth-choice minimax-global-api
  • MiniMax API key (CN): --auth-choice minimax-cn-api
  • 驗證：MINIMAX_API_KEY 用於 minimax；MINIMAX_OAUTH_TOKEN 或 MINIMAX_API_KEY 用於 minimax-portal

請參閱 /providers/minimax 以了解設定細節、模型選項及設定範例。

外掛擁有的功能拆分：

  • 文字/聊天預設值維持在 minimax/MiniMax-M2.7
  • 影像生成是 minimax/image-01 或 minimax-portal/image-01
  • 影像理解在兩種 MiniMax 驗證路徑上皆為外掛擁有的 MiniMax-VL-01
  • 網路搜尋維持在供應商 ID minimax

LM Studio

Section titled “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

Section titled “Ollama”

Ollama 作為內建的供應商外掛發布，並使用 Ollama 的原生 API：

Terminal window
# Install Ollama, then pull a model:
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

Section titled “vLLM”

vLLM 作為內建的供應商外掛發布，用於本機/自託管的 OpenAI 相容伺服器：

  • 供應商：vllm
  • 驗證：可選（取決於您的伺服器）
  • 預設基礎 URL：http://127.0.0.1:8000/v1

若要在本機選擇加入自動探索（如果您的伺服器不強制執行驗證，則任何值均可）：

Terminal window
export VLLM_API_KEY="vllm-local"

然後設定一個模型（替換為 /v1/models 傳回的其中一個 ID）：

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

詳情請參閱 /providers/vllm。

SGLang

Section titled “SGLang”

SGLang 作為一個內建供應商插件，用於快速的自託管 OpenAI 相容伺服器：

  • 供應商：sglang
  • 驗證：選用（取決於您的伺服器）
  • 預設基礎 URL：http://127.0.0.1:30000/v1

若要在本機選擇啟用自動探索（如果您的伺服器不強制執行驗證，則任何值均可）：

Terminal window
export SGLANG_API_KEY="sglang-local"

然後設定一個模型（替換為 /v1/models 返回的其中一個 ID）：

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

詳情請參閱 /providers/sglang。

本機代理（LM Studio、vLLM、LiteLLM 等）

Section titled “本機代理（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,
          },
        ],
      },
    },
  },
}
預設可選欄位

對於自訂供應商，reasoning、input、cost、contextWindow 和 maxTokens 是可選的。如果省略，OpenClaw 預設為：

  • reasoning: false
  • input: ["text"]
  • cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 }
  • contextWindow: 200000
  • maxTokens: 8192

建議：設定符合您的代理/模型限制的明確值。

Proxy-route shaping rules
  • 對於非原生端點上的 api: "openai-completions"（任何主機不是 api.openai.com 的非空 baseUrl），OpenClaw 強制執行 compat.supportsDeveloperRole: false 以避免因不支援的 developer 角色而導致的提供商 400 錯誤。
  • 代理風格的 OpenAI 相容路由也會跳過原生 OpenAI 專屬的請求塑形：無 service_tier、無 Responses store、無 Completions store、無提示快取提示、無 OpenAI 推理相容負載塑形，且無隱藏的 OpenClaw 歸因標頭。
  • 對於需要特定供應商欄位的 OpenAI 相容 Completions 代理，請設定 agents.defaults.models["provider/model"].params.extra_body（或 extraBody）以將額外的 JSON 合併到傳出請求主體中。
  • 對於 vLLM 聊天範本控制，請設定 agents.defaults.models["provider/model"].params.chat_template_kwargs。當會話思考層級關閉時，內建的 vLLM 外掛程式會自動為 vllm/nemotron-3-* 傳送 enable_thinking: false 和 force_nonempty_content: true。
  • 對於緩慢的本地模型或遠端 LAN/tailnet 主機，請設定 `models.providers.

.timeoutSeconds。這會延長提供商模型 HTTP 請求處理，包括連線、標頭、主體串流和總受保護擷取中止，而不會增加整個代理程式執行逾時。如果 agents.defaults.timeoutSeconds或特定執行的逾時較低，請一併提高該上限；提供商逾時無法延長整個執行時間。 - 模型提供商 HTTP 呼叫僅針對設定的提供商baseUrl主機名稱，允許198.18.0.0/15和fc00::/7中的 Surge、Clash 和 sing-box 假 IP DNS 回應。自訂/本地提供商端點也會信任該確切設定的scheme://host:port來源進行受保護的模型請求，包括回環、LAN 和 tailnet 主機。這不是一個新的設定選項；您設定的baseUrl僅會針對該來源擴充請求策略。假 IP 主機名稱允許和確切來源信任是獨立的機制。其他私網、回環、連結本機、元資料目的地和不同埠仍然需要明確的models.providers.

.request.allowPrivateNetwork: true加入。設定models.providers.

.request.allowPrivateNetwork: false以選擇退出確切來源信任。 - 如果baseUrl為空/省略，OpenClaw 將保持預設的 OpenAI 行為（即解析為api.openai.com）。 - 為了安全起見，明確的 compat.supportsDeveloperRole: true在非原生openai-completions端點上仍會被覆寫。 - 對於非直接端點上的api: “anthropic-messages”（任何非標準 anthropic的提供商，或主機不是公用api.anthropic.com端點的自訂models.providers.anthropic.baseUrl），OpenClaw 會隱含的 Anthropic beta 標頭（例如 claude-code-20250219、interleaved-thinking-2025-05-14和 OAuth 標記），以便自訂的 Anthropic 相容代理不會拒絕不支援的 beta 旗標。如果您的代理需要特定的 beta 功能，請明確設定models.providers.

.headers[“anthropic-beta”]`。

CLI 範例

Section titled “CLI 範例”
Terminal window
openclaw onboard --auth-choice opencode-zen
openclaw models set opencode/claude-opus-4-6
openclaw models list

另請參閱：Configuration 以取得完整的組態範例。

相關

Section titled “相關”