Saltar al contenido principal
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 codificación. El mismo Plugin incluido también registra Volcengine Speech como proveedor de TTS.
DetalleValor
Proveedoresvolcengine (general + TTS), volcengine-plan (codificación)
Autenticación del modeloVOLCANO_ENGINE_API_KEY
Autenticación de TTSVOLCENGINE_TTS_API_KEY o BYTEPLUS_SEED_SPEECH_API_KEY
APIModelos compatibles con OpenAI, TTS de BytePlus Seed Speech

​
Primeros pasos

1

Configurar la clave de API

Ejecuta la incorporación interactiva:
openclaw onboard --auth-choice volcengine-api-key
Esto registra los proveedores general (volcengine) y de codificación (volcengine-plan) desde una única clave de API.
2

Configurar un modelo predeterminado

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

Verificar que el modelo esté disponible

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
Para configuración no interactiva (CI, scripts), pasa la clave directamente:
openclaw onboard --non-interactive \
  --mode local \
  --auth-choice volcengine-api-key \
  --volcengine-api-key "$VOLCANO_ENGINE_API_KEY"

​
Proveedores y endpoints

ProveedorEndpointCaso de uso
volcengineark.cn-beijing.volces.com/api/v3Modelos generales
volcengine-planark.cn-beijing.volces.com/api/coding/v3Modelos de codificación
Ambos proveedores se configuran desde una única clave de API. La configuración registra ambos automáticamente, y el selector de modelos del proveedor de codificación también reutiliza la autenticación del proveedor general (volcengine-plan es un alias de autenticación de volcengine).

​
Catálogo integrado

Ref. de modeloNombreEntradaContexto
volcengine/deepseek-v3-2-251201DeepSeek V3.2text, image128,000
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8text, image256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028text, image256,000
volcengine/glm-4-7-251222GLM 4.7text, image200,000
volcengine/kimi-k2-5-260127Kimi K2.5text, image256,000
Ambos catálogos son estáticos (sin llamada de descubrimiento a /models) y admiten contabilidad de 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

Volcengine TTS usa la API HTTP de BytePlus Seed Speech (voice.ap-southeast-1.bytepluses.com) y se configura por separado de la clave de API de modelos Doubao compatible con OpenAI. En la consola de BytePlus, abre Seed Speech > Settings > API Keys, copia la clave de API y luego configura: 
export VOLCENGINE_TTS_API_KEY="byteplus_seed_speech_api_key"
export VOLCENGINE_TTS_RESOURCE_ID="seed-tts-1.0"
Luego actívalo en 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 disponibles en messages.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 anulaciones de configuración de voz. Para destinos de notas de voz, OpenClaw solicita el formato nativo del proveedor ogg_opus. Para adjuntos de audio normales, solicita mp3. Los alias de proveedor bytedance y doubao también se resuelven a este proveedor de voz. El ID de recurso predeterminado es seed-tts-1.0, el derecho que BytePlus concede de forma predeterminada a las claves de API de Seed Speech recién creadas. Si tu proyecto tiene derecho a TTS 2.0, configura VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.
VOLCANO_ENGINE_API_KEY es para los endpoints de modelos ModelArk/Doubao y no es una clave de API de Seed Speech. TTS necesita una clave de API de Seed Speech desde la consola de BytePlus Speech, o un par AppID/token heredado de Speech Console.
La autenticación heredada con AppID/token sigue siendo compatible para 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 anulan los campos de configuración correspondientes de messages.tts.providers.volcengine cuando están definidas.

​
Configuración avanzada

openclaw onboard --auth-choice volcengine-api-key configura volcengine-plan/ark-code-latest como modelo predeterminado y también registra el catálogo general volcengine.
Durante la selección de modelo en incorporación/configuración, la opción de autenticación de Volcengine prefiere filas tanto de volcengine/* como de volcengine-plan/*. Si esos modelos aún no están cargados, OpenClaw recurre al catálogo sin filtrar en lugar de mostrar un selector vacío limitado al proveedor.
Si el Gateway se ejecuta como daemon (launchd/systemd), asegúrate 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 configuradas en tu shell interactivo no se heredan automáticamente. Consulta la nota sobre daemon anterior.

​
Relacionado

Selección de modelos

Elección de proveedores, refs. de modelo y comportamiento de conmutación por error.

Configuración

Referencia completa de configuración 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.