Providers
Volcengine (Doubao)
O provedor Volcengine oferece acesso aos modelos Doubao e a modelos de terceiros hospedados no Volcano Engine, com endpoints separados para cargas de trabalho gerais e de programação. O mesmo plugin incluído também registra o Volcengine Speech como provedor de TTS.
| Detalhe | Valor |
|---|---|
| Provedores | volcengine (geral + TTS), volcengine-plan (programação) |
| Autenticação do modelo | VOLCANO_ENGINE_API_KEY |
| Autenticação de TTS | VOLCENGINE_TTS_API_KEY ou BYTEPLUS_SEED_SPEECH_API_KEY |
| API | Modelos compatíveis com OpenAI, TTS BytePlus Seed Speech |
Primeiros passos
Set the API key
Execute a configuração inicial interativa:
openclaw onboard --auth-choice volcengine-api-keyIsso registra os provedores geral (volcengine) e de programação (volcengine-plan) usando uma única chave de API.
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-planProvedores e endpoints
| Provedor | Endpoint | Caso de uso |
|---|---|---|
volcengine |
ark.cn-beijing.volces.com/api/v3 |
Modelos gerais |
volcengine-plan |
ark.cn-beijing.volces.com/api/coding/v3 |
Modelos de programação |
Catálogo integrado
General (volcengine)
| Referência do modelo | Nome | Entrada | Contexto |
|---|---|---|---|
volcengine/deepseek-v3-2-251201 |
DeepSeek V3.2 | texto, imagem | 128,000 |
volcengine/doubao-seed-1-8-251228 |
Doubao Seed 1.8 | texto, imagem | 256,000 |
volcengine/doubao-seed-code-preview-251028 |
doubao-seed-code-preview-251028 | texto, imagem | 256,000 |
volcengine/glm-4-7-251222 |
GLM 4.7 | texto, imagem | 200,000 |
volcengine/kimi-k2-5-260127 |
Kimi K2.5 | texto, imagem | 256,000 |
Coding (volcengine-plan)
| Referência do modelo | Nome | Entrada | Contexto |
|---|---|---|---|
volcengine-plan/ark-code-latest |
Ark Coding Plan | texto | 256,000 |
volcengine-plan/doubao-seed-code |
Doubao Seed Code | texto | 256,000 |
volcengine-plan/doubao-seed-code-preview-251028 |
Doubao Seed Code Preview | texto | 256,000 |
volcengine-plan/glm-4.7 |
GLM 4.7 Coding | texto | 200,000 |
volcengine-plan/kimi-k2-thinking |
Kimi K2 Thinking | texto | 256,000 |
volcengine-plan/kimi-k2.5 |
Kimi K2.5 Coding | texto | 256,000 |
Ambos os catálogos são estáticos (sem chamada de descoberta a /models) e oferecem contabilização de uso em streaming compatível com OpenAI. Os esquemas de ferramentas de ambos os provedores removem automaticamente as palavras-chave minLength, maxLength, minItems, maxItems, minContains e maxContains, pois a API de chamadas de ferramentas do Volcengine as rejeita.
Conversão de texto em fala
O TTS do Volcengine usa a API HTTP BytePlus Seed Speech (voice.ap-southeast-1.bytepluses.com) e é configurado separadamente da chave de API dos modelos Doubao compatíveis com OpenAI. No console do BytePlus, abra Seed Speech > Settings > API Keys, copie a chave de API e defina:
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"Em seguida, habilite-o em 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, }, }, }, },}Campos disponíveis em messages.tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey e baseUrl. !emotion=<value> também funciona como uma diretiva de voz embutida quando substituições das configurações de voz são permitidas.
Para destinos de mensagens de voz, o OpenClaw solicita o formato nativo do provedor ogg_opus. Para anexos de áudio comuns, solicita mp3. Os aliases de provedor bytedance e doubao também são resolvidos para esse provedor de fala.
O identificador de recurso padrão é seed-tts-1.0, a permissão que o BytePlus concede por padrão às chaves de API Seed Speech recém-criadas. Se o seu projeto tiver permissão para TTS 2.0, defina VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
A autenticação legada com AppID/token continua disponível para aplicações mais antigas do Speech Console:
export VOLCENGINE_TTS_APPID="speech_app_id"export VOLCENGINE_TTS_TOKEN="speech_access_token"export VOLCENGINE_TTS_CLUSTER="volcano_tts"Outras variáveis de ambiente opcionais de TTS: VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY e VOLCENGINE_TTS_BASE_URL substituem os campos de configuração correspondentes em messages.tts.providers.volcengine quando definidas.
Configuração avançada
Default model after onboarding
openclaw onboard --auth-choice volcengine-api-key define volcengine-plan/ark-code-latest como o modelo padrão e também registra o catálogo geral volcengine.
Model picker fallback behavior
Durante a seleção de modelos na configuração inicial ou na configuração, a opção de autenticação do Volcengine prioriza linhas de volcengine/* e volcengine-plan/*. Se esses modelos ainda não estiverem carregados, o OpenClaw recorre ao catálogo não filtrado em vez de exibir um seletor vazio com escopo limitado ao provedor.
Environment variables for daemon processes
Se o Gateway for executado como daemon (launchd/systemd), verifique se as variáveis de ambiente do modelo e de TTS, como VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID e VOLCENGINE_TTS_TOKEN, estão disponíveis para esse processo (por exemplo, em ~/.openclaw/.env ou por meio de env.shellEnv).
