OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Volcengine (Doubao)

El proveedor Volcengine da acceso a los 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

  • Configurar la clave de API

    Ejecuta la incorporación interactiva:

    bash
    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.

  • Configurar un modelo predeterminado

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

  • Verificar que el modelo esté disponible

    bash
    openclaw models list --provider volcengineopenclaw models list --provider volcengine-plan

    • 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

    Catálogo integrado

    General (volcengine)

    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

    Programación (volcengine-plan)

    Referencia del modelo Nombre Entrada Contexto
    volcengine-plan/ark-code-latest Plan de programación Ark texto 256,000
    volcengine-plan/doubao-seed-code Doubao Seed Code texto 256,000
    volcengine-plan/doubao-seed-code-preview-251028 Vista previa de Doubao Seed Code texto 256,000
    volcengine-plan/glm-4.7 Programación con GLM 4.7 texto 200,000
    volcengine-plan/kimi-k2-thinking Razonamiento Kimi K2 texto 256,000
    volcengine-plan/kimi-k2.5 Programación con Kimi K2.5 texto 256,000

    Ambos catálogos son estáticos (sin una llamada de descubrimiento a /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, abre Seed Speech > Settings > API Keys, copia la clave de API y, a continuación, configura:

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

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

    json5
    {  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 las anulaciones de la configuración de voz.

    Para destinos de notas de voz, OpenClaw solicita el formato nativo del proveedor ogg_opus. Para archivos de audio adjuntos normales, solicita mp3. Los alias de proveedor bytedance y doubao también se resuelven a 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 tu proyecto cuenta con autorización para TTS 2.0, configura VOLCENGINE_TTS_RESOURCE_ID=seed-tts-2.0.

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

    bash
    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, cuando están configuradas, los campos correspondientes de la configuración messages.tts.providers.volcengine.

    Configuración avanzada

    Modelo predeterminado después de la incorporación

    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.

    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 están cargados, OpenClaw recurre al catálogo sin filtrar en lugar de mostrar un selector vacío limitado al proveedor.

    Variables de entorno para procesos demonio

    Si el Gateway se ejecuta como demonio (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).

    Contenido relacionado

    Selección de modelos

    Elección de proveedores, referencias de modelos 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.
    Was this useful?
    On this page

    On this page