官方提供商插件

官方提供商插件¶

官方提供商插件会发布自己的模型目录条目。这些提供商无需 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 驱逐）会在同一轮中使用完整请求重试一次。
• 对于自定义 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 后端：anthropic/claude-opus-5-5 配合模型范围的 agentRuntime.id: "claude-cli"。旧版 claude-cli/claude-opus-4-7 引用仍可兼容使用。

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

OpenAI ChatGPT/Codex OAuth¶

• 提供商：openai
• 身份验证：OAuth（ChatGPT）
• 全新原生 Codex 应用服务器执行框架引用：openai/gpt-6-astra
• 原生 Codex 应用服务器执行框架文档：Codex 执行框架
• 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 值和有效的截止键是可移植的强类型智能体运行时控件。它们不算是编写的提供商请求参数，也不选择运行时。当某个方案依赖某一运行时，请固定 agentRuntime.id: "openclaw" 或 agentRuntime.id: "codex"。
• 隐藏的 OpenClaw 归属标头（originator、version、User-Agent）仅附加在发送到 chatgpt.com/backend-api 的原生 Codex 流量上，不适用于通用 OpenAI 兼容代理。
• 共享的 /fast 切换、配置的默认值和有效的模型范围快速参数通过一个运行时控件策略解析。优先级请参阅 思考级别。
• OpenAI API 快速模式为溢价定价且特定于模型。GPT-5.6 Sol 目前费用为标准 Token 定价的 2 倍，且长上下文倍率会叠加。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 访问。
• 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

其他内置提供商插件¶

值得了解的怪癖¶