火山引擎（豆包）

Volcengine 提供者可存取託管於 Volcano Engine 的豆包模型與第三方模型，並針對一般工作負載與程式設計工作負載使用不同的端點。同一個內建外掛也會將 Volcengine Speech 註冊為 TTS 提供者。

開始使用

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

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

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

提供者與端點

內建目錄

兩個目錄都是靜態的（不會呼叫 /models 探索），並支援 OpenAI 相容的串流用量計算。兩個提供者的工具結構描述都會自動移除 minLength、maxLength、minItems、maxItems、minContains 與 maxContains 關鍵字，因為 Volcengine 工具呼叫 API 會拒絕這些關鍵字。

文字轉語音

Volcengine TTS 使用 BytePlus Seed Speech HTTP API（voice.ap-southeast-1.bytepluses.com），其設定與 OpenAI 相容的豆包模型 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 中啟用：

{  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 金鑰的權益。如果你的專案具有 TTS 2.0 權益，請設定 VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0。

較舊的 Speech Console 應用程式仍支援舊版 AppID／權杖驗證：

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 設定欄位。

進階設定

相關內容