Pular para o conteúdo principal

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.

O provedor Volcengine dá 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 pode registrar o Volcengine Speech como provedor de TTS.
DetalheValor
Provedoresvolcengine (geral + TTS) + volcengine-plan (programação)
Autenticação do modeloVOLCANO_ENGINE_API_KEY
Autenticação de TTSVOLCENGINE_TTS_API_KEY ou BYTEPLUS_SEED_SPEECH_API_KEY
APIModelos compatíveis com OpenAI, BytePlus Seed Speech TTS

​
Primeiros passos

1

Defina a chave de API

Execute a configuração interativa:
openclaw onboard --auth-choice volcengine-api-key
Isso registra os provedores geral (volcengine) e de programação (volcengine-plan) a partir de uma única chave de API.
2

Defina um modelo padrão

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

Verifique se o modelo está disponível

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
Para configuração não interativa (CI, scripts), passe a chave diretamente:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
Provedores e endpoints

ProvedorEndpointCaso de uso
volcengineark.cn-beijing.volces.com/api/v3Modelos gerais
volcengine-planark.cn-beijing.volces.com/api/coding/v3Modelos de programação
Ambos os provedores são configurados a partir de uma única chave de API. A configuração registra ambos automaticamente.

​
Catálogo integrado

Ref. do modeloNomeEntradaContexto
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8texto, imagem256.000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028texto, imagem256.000
volcengine/kimi-k2-5-260127Kimi K2.5texto, imagem256.000
volcengine/glm-4-7-251222GLM 4.7texto, imagem200.000
volcengine/deepseek-v3-2-251201DeepSeek V3.2texto, imagem128.000

​
Conversão de texto em fala

O TTS do Volcengine usa a API HTTP BytePlus Seed Speech e é configurado separadamente da chave de API do modelo Doubao compatível com OpenAI. No console do BytePlus, abra Seed Speech > Settings > API Keys e copie a chave de API; em seguida, 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,
        },
      },
    },
  },
}
Para destinos de nota de voz, o OpenClaw solicita ao Volcengine o formato nativo do provedor ogg_opus. Para anexos de áudio normais, solicita mp3. Os aliases de provedor bytedance e doubao também resolvem para o mesmo provedor de fala. O resource id padrão é seed-tts-1.0 porque é isso que o BytePlus concede a chaves de API Seed Speech recém-criadas no projeto padrão. Se o seu projeto tiver direito ao TTS 2.0, defina VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
VOLCANO_ENGINE_API_KEY é para os endpoints de modelo ModelArk/Doubao e não é uma chave de API do Seed Speech. O TTS precisa de uma chave de API do Seed Speech do BytePlus Speech Console, ou de um par AppID/token legado do Speech Console.
A autenticação legada com AppID/token continua com suporte 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"

​
Configuração avançada

openclaw onboard --auth-choice volcengine-api-key atualmente define volcengine-plan/ark-code-latest como o modelo padrão, enquanto também registra o catálogo geral volcengine.
Durante a configuração inicial/configuração da seleção de modelo, a opção de autenticação do Volcengine prioriza linhas volcengine/* e volcengine-plan/*. Se esses modelos ainda não tiverem sido carregados, o OpenClaw recorre ao catálogo sem filtro em vez de mostrar um seletor restrito ao provedor vazio.
Se o Gateway for executado como daemon (launchd/systemd), certifique-se de que as variáveis de ambiente do modelo e do TTS, como VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID e VOLCENGINE_TTS_TOKEN, estejam disponíveis para esse processo (por exemplo, em ~/.openclaw/.env ou via env.shellEnv).
Ao executar o OpenClaw como serviço em segundo plano, as variáveis de ambiente definidas no seu shell interativo não são herdadas automaticamente. Consulte a observação sobre daemon acima.

​
Relacionado

Seleção de modelo

Escolha de provedores, refs. de modelo e comportamento de failover.

Configuração

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

Solução de problemas

Problemas comuns e etapas de depuração.

FAQ

Perguntas frequentes sobre a configuração do OpenClaw.