Skip to main content

​
Volcengine（Doubao）

Volcengine 提供商可访问 Doubao 模型和托管在 Volcano Engine 上的第三方模型，并为通用工作负载和编码工作负载提供独立端点。
  • 提供商：volcengine（通用）+ volcengine-plan（编码）
  • 认证：VOLCANO_ENGINE_API_KEY
  • API：OpenAI-compatible

​
快速开始

  1. 设置 API 密钥：
openclaw onboard --auth-choice volcengine-api-key
  1. 设置默认模型：
{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}

​
非交互式示例

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
提供商和端点

提供商端点使用场景
volcengineark.cn-beijing.volces.com/api/v3通用模型
volcengine-planark.cn-beijing.volces.com/api/coding/v3编码模型
两个提供商都通过同一个 API 密钥进行配置。设置时会自动同时注册二者。

​
可用模型

通用提供商（volcengine）：
模型引用名称输入上下文
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8text, image256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028text, image256,000
volcengine/kimi-k2-5-260127Kimi K2.5text, image256,000
volcengine/glm-4-7-251222GLM 4.7text, image200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2text, image128,000
编码提供商（volcengine-plan）：
模型引用名称输入上下文
volcengine-plan/ark-code-latestArk Coding Plantext256,000
volcengine-plan/doubao-seed-codeDoubao Seed Codetext256,000
volcengine-plan/glm-4.7GLM 4.7 Codingtext200,000
volcengine-plan/kimi-k2-thinkingKimi K2 Thinkingtext256,000
volcengine-plan/kimi-k2.5Kimi K2.5 Codingtext256,000
volcengine-plan/doubao-seed-code-preview-251028Doubao Seed Code Previewtext256,000
openclaw onboard --auth-choice volcengine-api-key 当前会将 volcengine-plan/ark-code-latest 设为默认模型，同时也会注册通用的 volcengine 目录。 在新手引导/配置的模型选择过程中，Volcengine 认证选项会优先显示 volcengine/* 和 volcengine-plan/* 条目。如果这些模型尚未加载，OpenClaw 会回退到未过滤的目录，而不是显示一个空的按提供商限定的选择器。

​
环境说明

如果 Gateway 网关以守护进程方式运行（launchd/systemd），请确保 VOLCANO_ENGINE_API_KEY 对该进程可用（例如放在 ~/.openclaw/.env 中，或通过 env.shellEnv 提供）。