跳轉到主要內容

Documentation Index

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

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

Volcengine provider 可存取託管在 Volcano Engine 上的 Doubao 模型與第三方模型，並針對一般與程式碼工作負載提供不同端點。同一個內建 Plugin 也可以將 Volcengine Speech 註冊為 TTS provider。
詳細資訊值
Providervolcengine（一般 + TTS）+ volcengine-plan（程式碼）
模型驗證VOLCANO_ENGINE_API_KEY
TTS 驗證VOLCENGINE_TTS_API_KEY 或 BYTEPLUS_SEED_SPEECH_API_KEY
APIOpenAI 相容模型、BytePlus Seed Speech TTS

​
開始使用

1

Set the API key

執行互動式 onboarding：
openclaw onboard --auth-choice volcengine-api-key
這會使用單一 API key 註冊一般（volcengine）與程式碼（volcengine-plan）providers。
2

Set a default model

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

Verify the model is available

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
若要進行非互動式設定（CI、腳本），請直接傳入 key：
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
Provider 與端點

Provider端點用例
volcengineark.cn-beijing.volces.com/api/v3一般模型
volcengine-planark.cn-beijing.volces.com/api/coding/v3程式碼模型
兩個 providers 都使用單一 API key 設定。設定流程會自動註冊兩者。

​
內建目錄

模型 ref名稱輸入Context
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8text, image256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028text, image256,000
volcengine/kimi-k2-5-260127Kimi K2.5text, image256,000
volcengine/glm-4-7-251222GLM 4.7text, image200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2text, image128,000

​
文字轉語音

Volcengine TTS 使用 BytePlus Seed Speech HTTP API，並與 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 中啟用： 
{
  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 要求 provider 原生的 ogg_opus。針對一般音訊附件，則會要求 mp3。Provider alias bytedance 與 doubao 也會解析到相同的語音 provider。 預設 resource id 是 seed-tts-1.0，因為這是 BytePlus 在預設專案中授予新建立 Seed Speech API keys 的項目。如果你的專案具有 TTS 2.0 entitlement，請設定 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"

​
進階設定

openclaw onboard --auth-choice volcengine-api-key 目前會將 volcengine-plan/ark-code-latest 設為預設模型，同時也會註冊一般 volcengine 目錄。
在 onboarding/configure 模型選取期間，Volcengine 驗證選項會優先使用 volcengine/* 與 volcengine-plan/* 列。如果這些模型尚未載入，OpenClaw 會退回未篩選的目錄，而不是顯示空的 provider 範圍選取器。
如果 Gateway 以 daemon（launchd/systemd）方式執行，請確保模型與 TTS env vars，例如 VOLCANO_ENGINE_API_KEY、VOLCENGINE_TTS_API_KEY、BYTEPLUS_SEED_SPEECH_API_KEY、VOLCENGINE_TTS_APPID 與 VOLCENGINE_TTS_TOKEN，可供該 process 使用（例如在 ~/.openclaw/.env 中，或透過 env.shellEnv）。
當 OpenClaw 以背景服務執行時，互動式 shell 中設定的環境變數不會自動被繼承。請參閱上方的 daemon 說明。

​
相關

Model selection

選擇 providers、模型 refs 與 failover 行為。

Configuration

agents、models 與 providers 的完整設定參考。

Troubleshooting

常見問題與偵錯步驟。

FAQ

關於 OpenClaw 設定的常見問題。