官方提供商插件
官方提供商插件¶
官方提供商插件会发布它们自己的模型目录条目。这些提供商无需在 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/Codexopenai-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 密钥路由均会拒绝该模型。
如果 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 会将其映射到 Anthropicservice_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。
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" },
},
},
}
其他订阅式托管选项¶
MiniMax Coding Plan OAuth 或 API 密钥访问。
Qwen Cloud 提供商表面,外加 Alibaba DashScope 和 Coding Plan 端点映射。
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
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 缓存命中显示为 OpenClawcacheRead
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