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 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:

    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.

  • Establecer 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 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:

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

    json5
    {  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.

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

    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.
    Was this useful?
    On this page

    On this page