Skip to main content
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.

​
Primeiros passos

1

Set the API key

Execute a configuração inicial interativa:
Isso registra os provedores geral (volcengine) e de programação (volcengine-plan) usando uma única chave de API.
2

Set a default model

3

Verify the model is available

Para uma configuração não interativa (CI, scripts), forneça a chave diretamente:

​
Provedores e endpoints

Ambos os provedores são configurados com uma única chave de API. A configuração registra os dois automaticamente, e o seletor de modelos do provedor de programação também reutiliza a autenticação do provedor geral (volcengine-plan é um alias de autenticação de volcengine).

​
Catálogo integrado

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:
Em seguida, habilite-o em openclaw.json:
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.
VOLCANO_ENGINE_API_KEY destina-se aos endpoints dos modelos ModelArk/Doubao e não é uma chave de API Seed Speech. O TTS precisa de uma chave de API Seed Speech do BytePlus Speech Console ou de um par AppID/token legado do Speech Console.
A autenticação legada com AppID/token continua disponível para aplicações mais antigas do Speech Console:
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

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.
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.
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).
Ao executar o OpenClaw como serviço em segundo plano, as variáveis de ambiente definidas no shell interativo não são herdadas automaticamente. Consulte a observação sobre daemon acima.

​
Conteúdo relacionado

Model selection

Escolha de provedores, referências de modelos e comportamento de failover.

Configuration

Referência completa de configuração para agentes, modelos e provedores.

Troubleshooting

Problemas comuns e etapas de depuração.

FAQ

Perguntas frequentes sobre a configuração do OpenClaw.