Providers
火山引擎（豆包）
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 |
開始使用
Set the API key
執行互動式初始設定：
openclaw onboard --auth-choice volcengine-api-key這會使用單一 API 金鑰，同時註冊一般用途（volcengine）與程式設計用途（volcengine-plan）供應商。
Set a default model
{ agents: { defaults: { model: { primary: "volcengine-plan/ark-code-latest" }, }, },}Verify the model is available
openclaw models list --provider volcengineopenclaw models list --provider volcengine-plan供應商與端點
| 供應商 | 端點 | 使用情境 |
|---|---|---|
volcengine |
ark.cn-beijing.volces.com/api/v3 |
一般模型 |
volcengine-plan |
ark.cn-beijing.volces.com/api/coding/v3 |
程式設計模型 |
內建目錄
General (volcengine)
| 模型參照 | 名稱 | 輸入 | 上下文 |
|---|---|---|---|
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 |
Coding (volcengine-plan)
| 模型參照 | 名稱 | 輸入 | 上下文 |
|---|---|---|---|
volcengine-plan/ark-code-latest |
Ark Coding Plan | 文字 | 256,000 |
volcengine-plan/doubao-seed-code |
Doubao Seed Code | 文字 | 256,000 |
volcengine-plan/doubao-seed-code-preview-251028 |
Doubao Seed Code Preview | 文字 | 256,000 |
volcengine-plan/glm-4.7 |
GLM 4.7 Coding | 文字 | 200,000 |
volcengine-plan/kimi-k2-thinking |
Kimi K2 Thinking | 文字 | 256,000 |
volcengine-plan/kimi-k2.5 |
Kimi K2.5 Coding | 文字 | 256,000 |
兩個目錄都是靜態的（不會呼叫 /models 進行探索），並支援 OpenAI 相容的串流用量統計。兩個供應商的工具結構描述都會自動移除 minLength、maxLength、minItems、maxItems、minContains 和 maxContains 關鍵字，因為 Volcengine 工具呼叫 API 不接受這些關鍵字。
文字轉語音
Volcengine TTS 使用 BytePlus Seed Speech HTTP API（voice.ap-southeast-1.bytepluses.com），其設定與 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, }, }, }, },}messages.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；設定後會覆寫對應的 messages.tts.providers.volcengine 設定欄位。
進階設定
Default model after onboarding
openclaw onboard --auth-choice volcengine-api-key 會將 volcengine-plan/ark-code-latest 設為預設模型，同時註冊一般用途的 volcengine 目錄。
Model picker fallback behavior
在初始設定／設定模型選擇期間，Volcengine 驗證選項會優先顯示 volcengine/* 和 volcengine-plan/* 的項目。如果這些模型尚未載入，OpenClaw 會回退至未篩選的目錄，而不會顯示空白的供應商範圍模型選擇器。
Environment variables for daemon processes
如果閘道以常駐程式（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 提供）。
