Pular para o conteúdo principal

​
Volcengine (Doubao)

O provedor Volcengine dá acesso a modelos Doubao e a modelos de terceiros hospedados na Volcano Engine, com endpoints separados para cargas de trabalho gerais e de coding.
DetailValue
Provedoresvolcengine (geral) + volcengine-plan (coding)
AuthVOLCANO_ENGINE_API_KEY
APIcompatível com OpenAI

​
Introdução

1

Defina a chave de API

Execute o onboarding interativo:
openclaw onboard --auth-choice volcengine-api-key
Isso registra os provedores geral (volcengine) e de coding (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

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

​
Modelos disponíveis

Model refNameInputContext
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

​
Observações avançadas

openclaw onboard --auth-choice volcengine-api-key atualmente define volcengine-plan/ark-code-latest como modelo padrão ao mesmo tempo em que registra o catálogo geral volcengine.
Durante a seleção de modelo em onboarding/configure, o auth choice da Volcengine prefere linhas volcengine/* e volcengine-plan/*. Se esses modelos ainda não estiverem carregados, o OpenClaw faz fallback para o catálogo não filtrado em vez de mostrar um seletor com escopo de provedor vazio.
Se o Gateway for executado como daemon (launchd/systemd), certifique-se de que VOLCANO_ENGINE_API_KEY esteja disponível para esse processo (por exemplo, em ~/.openclaw/.env ou via env.shellEnv).
Ao executar o OpenClaw como serviço em segundo plano, variáveis de ambiente definidas no seu shell interativo não são herdadas automaticamente. Veja a observação sobre daemon acima.

​
Relacionado

Seleção de modelo

Escolhendo provedores, refs de modelo e comportamento de failover.

Configuração

Referência completa de config 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.