跳转至

官方提供商插件

官方提供商插件

官方提供商插件会发布它们自己的模型目录条目。这些提供商无需在 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-6-astra
  • 示例模型:openai/gpt-6-astra、openai/gpt-5.6-sol、openai/gpt-5.6-terra、openai/gpt-5.6-luna、openai/gpt-5.5;裸的直接 API 别名 openai/gpt-5.6 仍受支持。
  • 如果某个特定安装或 API 密钥行为不同,请使用 openclaw models list --provider openai 验证账户/模型可用性。
  • CLI:openclaw onboard --auth-choice openai-api-key
  • 直接使用 OpenAI API 密钥的 Responses 请求默认采用 "sse"。
  • 可按模型通过 agents.defaults.models["openai/<model>"].params.transport 覆盖("sse"、"websocket"、"websocket-cached" 或 "auto")。缓存 WebSocket 会复用会话连接,并在历史记录仍然匹配时仅发送包含 previous_response_id 的新输入。
  • "sse" 传输方式还支持位于精确公共 https://api.openai.com/v1 基础 URL 的原生 openai/openai-responses 模型的 HTTP 延续(ChatGPT/Codex openai-chatgpt-responses 路由被排除,并有意保持 store: false):OpenClaw 按“会话+凭证”缓存请求,当下一次对话的历史记录是前一次严格扩展时,仅发送新输入及 previous_response_id,而不是不断增长的完整历史记录。如果 previous_response_id 被拒绝或已过期(零数据保留、TTL 逐出),则在同一轮中使用完整请求重试一次。
  • 该进程内缓存在会话 90 分钟无对话后逐出会话基线;超过该间隔后,会重新发送一次完整历史记录并建立新基线。这是固定默认行为,不可由运维配置。
  • 对于自定义 openai-responses 模型,请在验证其端点支持存储的响应和 previous_response_id 之后,设置 models.providers.<provider>.models[].compat.supportsResponsesContinuation: true。这会为该模型启用 store: true,使后端即使在一轮无法继续时也能保留请求。其他自定义模型保持无状态。compat.supportsStore: false 可禁用此可选启用项。azure-openai-responses 和 ChatGPT/Codex 传输方式,以及 azure-openai 和 azure-openai-responses 提供商 ID,均被排除。
  • 使用 params.serviceTier 或 params.service_tier 设置显式 OpenAI API 服务层级;快速模式(原“优先处理”)使用 service_tier=priority。
  • 在原生公共 OpenAI 及 ChatGPT/Codex Responses 请求上,优先级依次为:载荷/传输的 service_tier、合法的显式模型参数、快速模式默认值。
  • /fast 以及合法的 params.fastMode/params.fast_mode 值是共享的代理运行时控制;在直接内置的 openai/* Responses 请求上,仅当不存在更高优先级层级时,它们才提供 service_tier=priority。
  • 隐藏的 OpenClaw 归属头(originator、version、User-Agent)仅适用于发送至 api.openai.com 的原生 OpenAI 流量,不适用于通用 OpenAI 兼容代理。
  • 原生 OpenAI 的提供商托管存储、提示缓存提示以及推理载荷整形均保持不变。原始原生传输调用默认保留 store: false。自定义模型延续的可选启用项仅启用存储;它不会启用提示缓存提示或服务端压缩。
  • openai/gpt-5.3-codex-spark 仅可通过 ChatGPT/Codex OAuth 使用;直接 OpenAI API 密钥和 Azure API 密钥路由均会拒绝该模型。
{
  agents: { defaults: { model: { primary: "openai/gpt-6-astra" } } },
}

如果 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-5
  • 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 后端:模型级 agentRuntime.id: "claude-cli" 配合 anthropic/claude-opus-5-5。旧版 claude-cli/claude-opus-4-7 引用仍可兼容使用。

Note

Claude CLI 复用(claude -p)是 OpenClaw 官方认可的集成路径。Anthropic 设置令牌认证仍受支持,但在可用时 OpenClaw 更倾向于复用 Claude CLI。

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

OpenAI ChatGPT/Codex OAuth

  • 提供商:openai
  • 认证:OAuth(ChatGPT)
  • 全新原生 Codex 应用服务器 harness 引用:openai/gpt-6-astra
  • 原生 Codex 应用服务器 harness 文档:Codex harness
  • 当账户支持时,Astra(openai/gpt-6-astra)默认使用 medium 推理强度。OpenAI 提供商默认 由模型控件和两种运行时共享;显式思考设置优先。
  • 旧版模型引用:codex/gpt-*、openai-codex/gpt-*
  • 插件边界:openai/* 加载 OpenAI 插件;显式运行时策略或提供商拥有的实际路由决定是否选择原生 Codex 应用服务器插件。
  • CLI: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 是编写的内置提供商请求设置。它们在 OpenClaw 上保持隐式运行时选择;原生 Codex 拥有自己的应用服务器传输和服务层级。
  • 合法的模型级 params.fastMode/params.fast_mode 值和合法的 cutoff 键是可移植的类型化代理运行时控件。它们不计为显式编写的提供商请求参数,也不会选择运行时。当方案依赖某个运行时,请固定 agentRuntime.id: "openclaw" 或 agentRuntime.id: "codex"。
  • 隐藏的 OpenClaw 归属头(originator、version、User-Agent)仅附加到发送至 chatgpt.com/backend-api 的原生 Codex 流量,不附加到通用 OpenAI 兼容代理。
  • 共享的 /fast 开关、配置的默认值以及合法的模型级 Fast 参数会通过同一个运行时控制策略解析。优先级请参阅 思考级别。
  • OpenAI API 快速模式为溢价且因模型而异。GPT-5.6 Sol 目前按 2 倍标准 Token 定价计费,长上下文倍数会进一步叠加。ChatGPT/Codex 积分快速模式是独立的:GPT-5.6 和 GPT-5.5 目前消耗 2.5 倍标准积分,而 API 密钥 Codex 运行使用 API Token 定价。请参阅 快速模式、API 定价 和 Codex 速度。
  • 原生 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-6-astra 进行全新的订阅支持设置。如果该 Codex 工作区未公开 Astra,请显式选择 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-6-astra" },
    },
  },
}
{
  models: {
    providers: {
      openai: {
        models: [{ id: "gpt-5.5", contextTokens: 160000 }],
      },
    },
  },
}

其他订阅式托管选项

MiniMax

MiniMax Coding Plan OAuth 或 API 密钥访问。

Qwen Cloud

Qwen Cloud 提供商表面,外加 Alibaba DashScope 和 Coding Plan 端点映射。

Z.AI (GLM)

Z.AI Coding Plan 或通用 API 端点。

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.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
  • 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:通过 gcloud Application Default Credentials 管理的 Google Cloud 访问。在网关服务环境中,若存在可识别的 ADC 文件,并且设置了 GOOGLE_CLOUD_PROJECT(或 GCLOUD_PROJECT)和 GOOGLE_CLOUD_LOCATION,OpenClaw 会自动发现该提供商,无需存储任何凭据。对于仅元数据凭据或显式覆盖,可通过存储字面哨兵值 gcp-vertex-credentials 来选择 ADC 路径。其他存储值会作为 API 密钥发送,而不是作为 ADC 凭据;请勿粘贴 OAuth 访问令牌。参见 Google 提供商设置。
  • google-gemini-cli:用于显式配置的规范 google/* 模型的可选本地运行时。

OpenClaw 不会创建 Gemini CLI OAuth 或 Antigravity OAuth 配置文件。请通过 AI Studio API 密钥或 Vertex AI 连接 Google。如果你显式选择 Gemini CLI 运行时,它可以使用所选的 Google API 密钥配置文件。现有有效的 Gemini CLI OAuth 配置文件仍保持运行时兼容,但它们不是设置或恢复途径。

Gemini CLI 默认使用 stream-json。OpenClaw 读取助手流消息,并将 stats.cached 规范化为 cacheRead;旧版 --output-format json 覆盖仍从 response 读取回复文本。

Z.AI(GLM)

  • 提供商:zai
  • 认证:ZAI_API_KEY
  • 示例模型:zai/glm-5.2
  • CLI: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
  • CLI:openclaw onboard --auth-choice ai-gateway-api-key

其他捆绑提供商插件

提供商 ID 认证环境变量 示例模型
Arcee arcee ARCEEAI_API_KEY 或 OPENROUTER_API_KEY arcee/trinity-large-thinking
BytePlus byteplus / byteplus-plan BYTEPLUS_API_KEY byteplus-plan/ark-code-latest
Cerebras cerebras CEREBRAS_API_KEY cerebras/zai-glm-4.7
Chutes chutes CHUTES_API_KEY 或 CHUTES_OAUTH_TOKEN chutes/zai-org/GLM-5-TEE
ClawRouter clawrouter CLAWROUTER_API_KEY clawrouter/anthropic/claude-sonnet-4-6
Cohere cohere COHERE_API_KEY cohere/command-a-plus-05-2026
DeepInfra deepinfra DEEPINFRA_API_KEY deepinfra/deepseek-ai/DeepSeek-V4-Flash
DeepSeek deepseek DEEPSEEK_API_KEY deepseek/deepseek-v4-flash
Featherless AI featherless FEATHERLESS_API_KEY featherless/Qwen/Qwen3-32B
提供商 ID 认证环境变量 示例模型
GitHub Copilot github-copilot COPILOT_GITHUB_TOKEN -
GMI Cloud gmi GMI_API_KEY gmi/google/gemini-3.1-flash-lite
Groq groq GROQ_API_KEY groq/llama-3.3-70b-versatile
Hugging Face Inference huggingface HUGGINGFACE_HUB_TOKEN 或 HF_TOKEN huggingface/deepseek-ai/DeepSeek-R1
MiniMax minimax / minimax-portal MINIMAX_API_KEY / MINIMAX_OAUTH_TOKEN minimax/MiniMax-M3
Mistral mistral MISTRAL_API_KEY mistral/mistral-large-latest
Moonshot moonshot MOONSHOT_API_KEY moonshot/kimi-k2.6
NVIDIA nvidia NVIDIA_API_KEY nvidia/nvidia/nemotron-3-ultra-550b-a55b
NovitaAI novita NOVITA_API_KEY novita/deepseek/deepseek-v3-0324
Ollama Cloud ollama-cloud OLLAMA_API_KEY ollama-cloud/kimi-k2.6
OpenRouter openrouter OpenRouter OAuth 或 OPENROUTER_API_KEY openrouter/auto
Qianfan qianfan QIANFAN_API_KEY qianfan/deepseek-v3.2
Tencent TokenHub tencent-tokenhub TOKENHUB_API_KEY tencent-tokenhub/hy3-preview
Together together TOGETHER_API_KEY together/meta-llama/Llama-3.3-70B-Instruct-Turbo
Venice venice VENICE_API_KEY -
Vercel AI Gateway vercel-ai-gateway AI_GATEWAY_API_KEY vercel-ai-gateway/anthropic/claude-opus-4.6
Volcano Engine (Doubao) volcengine / volcengine-plan VOLCANO_ENGINE_API_KEY volcengine-plan/ark-code-latest
xAI xai SuperGrok/X Premium OAuth 或 XAI_API_KEY xai/grok-4.7
Xiaomi xiaomi / xiaomi-token-plan XIAOMI_API_KEY / XIAOMI_TOKEN_PLAN_API_KEY xiaomi/mimo-v2.6-pro / xiaomi-token-plan/mimo-v2.6-pro

值得了解的怪癖

OpenRouter

它仅对已验证的 openrouter.ai 路由应用其应用归属请求头和 Anthropic cache_control 标记。DeepSeek、Moonshot 和 ZAI 模型引用符合 OpenRouter 管理的 Prompt 缓存的缓存 TTL 条件,但不会获得 Anthropic 缓存标记。作为代理式 OpenAI 兼容路径,它会跳过仅限原生 OpenAI 的请求整形(serviceTier、Responses store、Prompt 缓存提示、OpenAI 推理兼容)。Gemini 支持的模型引用仅保留代理 Gemini 思维签名清理。

Kilo Gateway

Gemini 支持的模型引用遵循相同的代理 Gemini 清理路径;kilocode/kilo-auto/balanced 以及其他不支持代理推理的模型引用会跳过代理推理注入。

MiniMax

API 密钥入门会写入显式的 M3 和 M2.7 聊天模型定义;图像理解仍使用插件拥有的 MiniMax-VL-01 媒体提供商。

NVIDIA

模型 ID 使用 nvidia/<vendor>/<model> 命名空间(例如 nvidia/nvidia/nemotron-...);选择器保留字面的 <provider>/<model-id> 组合,而发送到 API 的规范键保持单前缀。

xAI

使用 xAI Responses 路径。推荐路径是 SuperGrok/X Premium OAuth;OAuth 和 API 密钥设置使用精选的 xai/grok-4.7 默认值。现有主模型保持固定。运行 openclaw doctor --fix 以修复原生 API 和订阅路由上已退役的 xai/auto 选择。API 密钥仍可通过 XAI_API_KEY 或插件配置使用。Grok web_search 在回退到 API 密钥之前会复用相同的认证配置。旧的 /fast 和 params.fastMode: true 配置仍会通过 xAI 的 Grok 4.3 兼容重定向解析,但新配置应直接选择当前模型。tool_stream 默认开启;通过 agents.defaults.models["xai/<model>"].params.tool_stream=false 禁用。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw