火山引擎（豆包）

Volcengine 提供商可访问 Doubao 模型以及托管在 Volcano Engine 上的第三方模型，并为通用工作负载和编码工作负载提供不同的端点。同一个内置插件还会将 Volcengine Speech 注册为 TTS 提供商。

详情	值
提供商	`volcengine`（通用 + TTS）、`volcengine-plan`（编码）
模型身份验证	`VOLCANO_ENGINE_API_KEY`
TTS 身份验证	`VOLCENGINE_TTS_API_KEY` 或 `BYTEPLUS_SEED_SPEECH_API_KEY`
API	OpenAI 兼容模型、BytePlus Seed Speech TTS

入门指南

设置 API key

运行交互式新手引导：

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

这将使用一个 API key 同时注册通用（volcengine）和编码（volcengine-plan）提供商。

设置默认模型

{
  agents: {
    defaults: {
      model: { primary: "volcengine-plan/ark-code-latest" },
    },
  },
}

验证模型是否可用

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan

对于非交互式设置（CI、脚本），请直接传入密钥：

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

提供商和端点

提供商	端点	用途
`volcengine`	`ark.cn-beijing.volces.com/api/v3`	通用模型
`volcengine-plan`	`ark.cn-beijing.volces.com/api/coding/v3`	编码模型

两个提供商都使用同一个 API key 配置。设置过程会自动注册两者，并且编码提供商的模型选择器也会复用通用提供商的身份验证（volcengine-plan 是 volcengine 的身份验证别名）。

内置目录

通用（volcengine）
编码（volcengine-plan）

模型引用	名称	输入	上下文
`volcengine/deepseek-v3-2-251201`	DeepSeek V3.2	文本、图像	128,000
`volcengine/doubao-seed-1-8-251228`	Doubao Seed 1.8	文本、图像	256,000
`volcengine/doubao-seed-code-preview-251028`	doubao-seed-code-preview-251028	文本、图像	256,000
`volcengine/glm-4-7-251222`	GLM 4.7	文本、图像	200,000
`volcengine/kimi-k2-5-260127`	Kimi K2.5	文本、图像	256,000

模型引用	名称	输入	上下文
`volcengine-plan/ark-code-latest`	Ark Coding Plan	文本	256,000
`volcengine-plan/doubao-seed-code`	Doubao Seed Code	文本	256,000

两个目录都是静态的（不会调用 /models 进行发现），并支持与 OpenAI 兼容的流式用量统计。两个提供商的工具 schema 都会自动删除 minLength、maxLength、minItems、maxItems、minContains 和 maxContains 关键字，因为 Volcengine 工具调用 API 会拒绝它们。

文本转语音

Volcengine TTS 使用 BytePlus Seed Speech HTTP API（voice.ap-southeast-1.bytepluses.com），其配置与 OpenAI 兼容的 Doubao 模型 API key 分开。在 BytePlus 控制台中，打开 Seed Speech > Settings > API Keys，复制 API key，然后设置：

export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"

然后在 openclaw.json 中启用它：

{
  tts: {
    auto: "always",
    provider: "volcengine",
    providers: {
      volcengine: {
        apiKey: "byteplus_seed_speech_api_key",
        voice: "en_female_anna_mars_bigtts",
        speedRatio: 1.0,
      },
    },
  },
}

tts.providers.volcengine 下的可用字段：apiKey、voice、speedRatio（0.2-3.0）、emotion、cluster、resourceId、appKey 和 baseUrl。允许语音设置覆盖时，!emotion=<value> 也可作为内联语音指令使用。对于语音消息目标，OpenClaw 会请求提供商原生的 ogg_opus。对于普通音频附件，它会请求 mp3。提供商别名 bytedance 和 doubao 也会解析到此语音提供商。默认资源 ID 为 seed-tts-1.0，这是 BytePlus 默认授予新建 Seed Speech API key 的权限。如果你的项目具有 TTS 2.0 权限，请设置 VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0。

VOLCANO_ENGINE_API_KEY 用于 ModelArk/Doubao 模型端点，不是 Seed Speech API key。TTS 需要来自 BytePlus Speech Console 的 Seed Speech API key，或者旧版 Speech Console AppID/token 对。

旧版 Speech Console 应用仍支持 AppID/token 身份验证：

export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

其他可选的 TTS 环境变量：设置后，VOLCENGINE_TTS_VOICE、VOLCENGINE_TTS_APP_KEY 和 VOLCENGINE_TTS_BASE_URL 会覆盖相应的 tts.providers.volcengine 配置字段。

高级配置

新手引导后的默认模型

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、VOLCENGINE_TTS_API_KEY、BYTEPLUS_SEED_SPEECH_API_KEY、VOLCENGINE_TTS_APPID 和 VOLCENGINE_TTS_TOKEN 等模型及 TTS 环境变量（例如在 ~/.openclaw/.env 中设置，或通过 env.shellEnv 设置）。

将 OpenClaw 作为后台服务运行时，交互式 shell 中设置的环境变量不会自动被继承。请参阅上面的守护进程说明。

模型选择

选择提供商、模型引用和故障转移行为。

配置

智能体、模型和提供商的完整配置参考。

故障排查

常见问题和调试步骤。

常见问题

有关 OpenClaw 设置的常见问题。

概览

模型概念

提供商

火山引擎（豆包）

入门指南

提供商和端点

内置目录

文本转语音

高级配置

相关内容

模型选择

配置

故障排查

常见问题

​入门指南

​提供商和端点

​内置目录

​文本转语音

​高级配置

​相关内容

模型选择

配置

故障排查

常见问题

入门指南

提供商和端点

内置目录

文本转语音

高级配置

相关内容