Volcengine（豆包）

火山引擎 provider 提供对豆包（Doubao）模型及火山引擎平台托管的第三方模型的访问，针对通用和编程工作负载分别提供独立端点。

• Providers：volcengine（通用）+ volcengine-plan（编程）
• Auth：VOLCANO_ENGINE_API_KEY
• API：OpenAI 兼容

快速上手

1. 设置 API Key：

openclaw onboard --auth-choice volcengine-api-key

2. 设置默认模型：

{
  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"

Provider 与端点对照

Provider	端点	用途
volcengine	ark.cn-beijing.volces.com/api/v3	通用模型
volcengine-plan	ark.cn-beijing.volces.com/api/coding/v3	编程模型

两个 provider 共用同一 API Key，一次配置自动注册两个——让你的龙虾一键搞定通用和编程双端。

可用模型

• doubao-seed-1-8 —— 豆包 Seed 1.8（通用，默认）
• doubao-seed-code-preview —— 豆包编程专用模型
• ark-code-latest —— Coding Plan 默认模型
• Kimi K2.5 —— 通过火山引擎接入的 Moonshot AI
• GLM-4.7 —— 通过火山引擎接入的 GLM
• DeepSeek V3.2 —— 通过火山引擎接入的 DeepSeek

大部分模型支持文本 + 图像输入，上下文窗口从 128K 到 256K tokens 不等。

环境变量说明

如果 Gateway 以守护进程（launchd/systemd）方式运行，需确保 VOLCANO_ENGINE_API_KEY 对该进程可见（例如写入 ~/.openclaw/.env 或通过 env.shellEnv 配置）。