Volcengine (Doubao)

El proveedor Volcengine da acceso a modelos Doubao y a modelos de terceros alojados en Volcano Engine, con endpoints separados para cargas de trabajo generales y de programación. El mismo plugin incluido también registra Volcengine Speech como proveedor de TTS.

Detalle	Valor
Proveedores	`volcengine` (general + TTS), `volcengine-plan` (programación)
Autenticación de modelos	`VOLCANO_ENGINE_API_KEY`
Autenticación de TTS	`VOLCENGINE_TTS_API_KEY` o `BYTEPLUS_SEED_SPEECH_API_KEY`
API	Modelos compatibles con OpenAI, TTS de BytePlus Seed Speech

Primeros pasos

Establecer la clave de API

Ejecute la incorporación interactiva:

openclaw onboard --auth-choice volcengine-api-key

Esto registra tanto el proveedor general (volcengine) como el de programación (volcengine-plan) a partir de una única clave de API.

Establecer un modelo predeterminado

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

Verificar que el modelo esté disponible

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan

Para una configuración no interactiva (CI, scripts), pase la clave directamente:

openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

Proveedores y endpoints

Proveedor	Endpoint	Caso de uso
`volcengine`	`ark.cn-beijing.volces.com/api/v3`	Modelos generales
`volcengine-plan`	`ark.cn-beijing.volces.com/api/coding/v3`	Modelos de programación

Ambos proveedores se configuran a partir de una única clave de API. La configuración registra ambos automáticamente, y el selector de modelos del proveedor de programación también reutiliza la autenticación del proveedor general (volcengine-plan es un alias de autenticación de volcengine).

Catálogo integrado

General (volcengine)
Programación (volcengine-plan)

Referencia del modelo	Nombre	Entrada	Contexto
`volcengine/deepseek-v3-2-251201`	DeepSeek V3.2	texto, imagen	128,000
`volcengine/doubao-seed-1-8-251228`	Doubao Seed 1.8	texto, imagen	256,000
`volcengine/doubao-seed-code-preview-251028`	doubao-seed-code-preview-251028	texto, imagen	256,000
`volcengine/glm-4-7-251222`	GLM 4.7	texto, imagen	200,000
`volcengine/kimi-k2-5-260127`	Kimi K2.5	texto, imagen	256,000

Referencia del modelo	Nombre	Entrada	Contexto
`volcengine-plan/ark-code-latest`	Ark Coding Plan	texto	256,000
`volcengine-plan/doubao-seed-code`	Doubao Seed Code	texto	256,000

Ambos catálogos son estáticos (sin llamada de descubrimiento /models) y admiten la contabilización del uso en streaming compatible con OpenAI. Los esquemas de herramientas de ambos proveedores eliminan automáticamente las palabras clave minLength, maxLength, minItems, maxItems, minContains y maxContains, ya que la API de llamadas a herramientas de Volcengine las rechaza.

Texto a voz

El TTS de Volcengine utiliza la API HTTP de BytePlus Seed Speech (voice.ap-southeast-1.bytepluses.com) y se configura por separado de la clave de API de los modelos Doubao compatibles con OpenAI. En la consola de BytePlus, abra Seed Speech > Settings > API Keys, copie la clave de API y, a continuación, establezca:

export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"

Después, habilítelo en openclaw.json:

{
  tts: {
    auto: "always",
    provider: "volcengine",
    providers: {
      volcengine: {
        apiKey: "byteplus_seed_speech_api_key",
        voice: "en_female_anna_mars_bigtts",
        speedRatio: 1.0,
      },
    },
  },
}

Campos disponibles en tts.providers.volcengine: apiKey, voice, speedRatio (0.2-3.0), emotion, cluster, resourceId, appKey y baseUrl. !emotion=<value> también funciona como directiva de voz en línea cuando se permiten las anulaciones de la configuración de voz. Para destinos de notas de voz, OpenClaw solicita ogg_opus nativo del proveedor. Para archivos adjuntos de audio normales, solicita mp3. Los alias de proveedor bytedance y doubao también se resuelven en este proveedor de voz. El identificador de recurso predeterminado es seed-tts-1.0, la autorización que BytePlus concede de forma predeterminada a las claves de API de Seed Speech recién creadas. Si el proyecto tiene autorización para TTS 2.0, establezca VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.

VOLCANO_ENGINE_API_KEY corresponde a los endpoints de modelos ModelArk/Doubao y no es una clave de API de Seed Speech. TTS requiere una clave de API de Seed Speech de BytePlus Speech Console, o un par AppID/token heredado de Speech Console.

La autenticación heredada mediante AppID/token sigue siendo compatible con aplicaciones antiguas de Speech Console:

export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

Otras variables de entorno opcionales de TTS: VOLCENGINE_TTS_VOICE, VOLCENGINE_TTS_APP_KEY y VOLCENGINE_TTS_BASE_URL sustituyen los campos de configuración tts.providers.volcengine correspondientes cuando están establecidas.

Configuración avanzada

Modelo predeterminado tras la incorporación

openclaw onboard --auth-choice volcengine-api-key establece volcengine-plan/ark-code-latest como modelo predeterminado y también registra el catálogo general volcengine.

Comportamiento alternativo del selector de modelos

Durante la selección de modelos en la incorporación o configuración, la opción de autenticación de Volcengine da preferencia a las filas volcengine/* y volcengine-plan/*. Si esos modelos aún no se han cargado, OpenClaw utiliza como alternativa el catálogo sin filtrar en lugar de mostrar un selector vacío limitado al proveedor.

Variables de entorno para procesos daemon

Si el Gateway se ejecuta como daemon (launchd/systemd), asegúrese de que las variables de entorno de modelos y TTS, como VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, VOLCENGINE_TTS_APPID y VOLCENGINE_TTS_TOKEN, estén disponibles para ese proceso (por ejemplo, en ~/.openclaw/.env o mediante env.shellEnv).

Al ejecutar OpenClaw como servicio en segundo plano, las variables de entorno establecidas en el shell interactivo no se heredan automáticamente. Consulte la nota sobre el daemon anterior.

Contenido relacionado

Selección de modelos

Elección de proveedores, referencias de modelos y comportamiento de conmutación por error.

Configuración

Referencia de configuración completa para agentes, modelos y proveedores.

Solución de problemas

Problemas comunes y pasos de depuración.

Preguntas frecuentes

Preguntas frecuentes sobre la configuración de OpenClaw.

Overview

Concepts and configuration

Providers

Volcengine (Doubao)

Primeros pasos

Proveedores y endpoints

Catálogo integrado

Texto a voz

Configuración avanzada

Contenido relacionado

Selección de modelos

Configuración

Solución de problemas

Preguntas frecuentes

​Primeros pasos

​Proveedores y endpoints

​Catálogo integrado

​Texto a voz

​Configuración avanzada

​Contenido relacionado

Selección de modelos

Configuración

Solución de problemas

Preguntas frecuentes

Primeros pasos

Proveedores y endpoints

Catálogo integrado

Texto a voz

Configuración avanzada

Contenido relacionado