Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

El proveedor de 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 integrado también puede registrar Volcengine Speech como proveedor de TTS.
DetalleValor
Proveedoresvolcengine (general + TTS) + volcengine-plan (programació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

Configura la clave de API

Ejecuta la incorporación interactiva:
openclaw onboard --auth-choice volcengine-api-key
Esto registra los proveedores general (volcengine) y de programación (volcengine-plan) a partir de una sola clave de API.
2

Configura un modelo predeterminado

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

Verifica que el modelo esté disponible

openclaw models list --provider volcengine
openclaw models list --provider volcengine-plan
Para una configuración no interactiva (CI, scripting), 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 programación
Ambos proveedores se configuran a partir de una sola clave de API. La configuración registra ambos automáticamente.

​
Catálogo integrado

Referencia del modeloNombreEntradaContexto
volcengine/doubao-seed-1-8-251228Doubao Seed 1.8texto, imagen256,000
volcengine/doubao-seed-code-preview-251028doubao-seed-code-preview-251028texto, imagen256,000
volcengine/kimi-k2-5-260127Kimi K2.5texto, imagen256,000
volcengine/glm-4-7-251222GLM 4.7texto, imagen200,000
volcengine/deepseek-v3-2-251201DeepSeek V3.2texto, imagen128,000

​
Conversión de texto a voz

Volcengine TTS usa la API HTTP de BytePlus Seed Speech y se configura por separado de la clave de API del modelo Doubao compatible con OpenAI. En la consola de BytePlus, abre Seed Speech > Settings > API Keys y copia la clave de API; 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,
        },
      },
    },
  },
}
Para destinos de notas de voz, OpenClaw solicita a Volcengine el formato nativo del proveedor ogg_opus. Para adjuntos de audio normales, solicita mp3. Los alias del proveedor bytedance y doubao también se resuelven al mismo proveedor de voz. El id de recurso predeterminado es seed-tts-1.0 porque eso es lo que BytePlus concede a las claves de API de Seed Speech recién creadas en el proyecto predeterminado. Si tu proyecto tiene habilitación de 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 de la consola de BytePlus Speech, o un par heredado de AppID/token de la consola Speech.
La autenticación heredada con AppID/token sigue siendo compatible para aplicaciones antiguas de la consola Speech: 
export VOLCENGINE_TTS_APPID="speech_app_id"
export VOLCENGINE_TTS_TOKEN="speech_access_token"
export VOLCENGINE_TTS_CLUSTER="volcano_tts"

​
Configuración avanzada

openclaw onboard --auth-choice volcengine-api-key actualmente configura volcengine-plan/ark-code-latest como modelo predeterminado mientras también registra el catálogo general volcengine.
Durante la incorporación o la selección de modelos en la configuración, la opción de autenticación de Volcengine prioriza tanto las filas volcengine/* como volcengine-plan/*. Si esos modelos todavía no se han cargado, OpenClaw vuelve 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 del modelo 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).
Cuando OpenClaw se ejecuta como servicio en segundo plano, las variables de entorno configuradas en tu shell interactiva no se heredan automáticamente. Consulta la nota sobre daemon anterior.

​
Relacionado

Selección de modelos

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