Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Volcengine 提供商可访问托管在火山引擎上的 Doubao 模型和第三方模型，并为通用工作负载和编码工作负载提供独立端点。同一个内置插件还可以将 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

​
入门指南

1

设置 API 密钥

运行交互式新手引导：
openclaw onboard --auth-choice volcengine-api-key
这会使用同一个 API 密钥同时注册通用提供商（volcengine）和编码提供商（volcengine-plan）。
2

设置默认模型

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

验证模型可用

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"

​
提供商和端点

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

​
内置目录

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

​
文本转语音

Volcengine TTS 使用 BytePlus Seed Speech HTTP API，并且与兼容 OpenAI 的 Doubao 模型 API 密钥分开配置。在 BytePlus 控制台中，打开 Seed Speech > Settings > API Keys，复制 API 密钥，然后设置： 
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"
然后在 openclaw.json 中启用它： 
{
  messages: {
    tts: {
      auto: "always",
      provider: "volcengine",
      providers: {
        volcengine: {
          apiKey: "byteplus_seed_speech_api_key",
          voice: "en_female_anna_mars_bigtts",
          speedRatio: 1.0,
        },
      },
    },
  },
}
对于语音便笺目标，OpenClaw 会向 Volcengine 请求提供商原生的 ogg_opus。对于普通音频附件，则会请求 mp3。提供商别名 bytedance 和 doubao 也会解析到同一个语音提供商。 默认资源 ID 是 seed-tts-1.0，因为 BytePlus 会将它授予默认项目中新创建的 Seed Speech API 密钥。如果你的项目具有 TTS 2.0 权限，请设置 VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0。
VOLCANO_ENGINE_API_KEY 用于 ModelArk/Doubao 模型端点，并不是 Seed Speech API 密钥。TTS 需要来自 BytePlus Speech Console 的 Seed Speech API 密钥，或者旧版 Speech Console AppID/token 对。
旧版 AppID/token 凭证方式仍然支持较早的 Speech Console 应用： 
export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

​
高级配置

openclaw onboard --auth-choice volcengine-api-key 目前会将 volcengine-plan/ark-code-latest 设置为默认模型，同时也会注册通用的 volcengine 目录。
在新手引导/配置模型选择期间，Volcengine 凭证选项会优先选择 volcengine/* 和 volcengine-plan/* 两类条目。如果这些模型尚未加载， OpenClaw 会回退到未筛选的目录，而不是显示一个空的按提供商范围筛选的选择器。
如果 Gateway 网关 以守护进程方式运行（launchd/systemd），请确保模型和 TTS 环境变量（如 VOLCANO_ENGINE_API_KEY、VOLCENGINE_TTS_API_KEY、 BYTEPLUS_SEED_SPEECH_API_KEY、VOLCENGINE_TTS_APPID 和 VOLCENGINE_TTS_TOKEN）对该进程可用（例如在 ~/.openclaw/.env 中，或通过 env.shellEnv 提供）。
当 OpenClaw 作为后台服务运行时，你在交互式 shell 中设置的环境变量不会自动被继承。参见上面的守护进程说明。

​
相关内容

模型选择

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

配置

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

故障排除

常见问题和调试步骤。

常见问题

关于 OpenClaw 设置的常见问题解答。