Providers

Gradium

Gradium es un proveedor de texto a voz para OpenClaw. Genera respuestas de audio estándar (WAV), salida Opus compatible con notas de voz y audio u-law de 8 kHz para interfaces de telefonía.

Propiedad	Valor
Id. del proveedor	`gradium`
Autenticación	`GRADIUM_API_KEY` o `apiKey` en la configuración
URL base	`https://api.gradium.ai` (predeterminada)
Voz predeterminada	`Emma` (`YTpq7expH9539ERJ`)

Instalar el plugin

Gradium es un plugin externo oficial. Instálelo y, a continuación, reinicie Gateway:

bash

openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

Configuración inicial

Cree una clave de API de Gradium y, a continuación, expóngala mediante una variable de entorno o la clave de configuración. La configuración tiene prioridad sobre la variable de entorno.

Variable de entorno

bash

export GRADIUM_API_KEY="gsk_..."

Clave de configuración

json5

{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          apiKey: "${GRADIUM_API_KEY}",        },      },    },  },}

Configuración

json5

{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          speakerVoiceId: "YTpq7expH9539ERJ",          // apiKey: "${GRADIUM_API_KEY}",          // baseUrl: "https://api.gradium.ai",        },      },    },  },}

Clave	Tipo	Descripción
`messages.tts.providers.gradium.apiKey`	string	Clave de API resuelta. Admite `${ENV}` y referencias a secretos.
`messages.tts.providers.gradium.baseUrl`	string	URL HTTPS de la API de Gradium en `api.gradium.ai`. Se eliminan las barras diagonales finales. Valor predeterminado: `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	string	Id. de voz predeterminado que se utiliza cuando no existe una directiva de sustitución.

El formato de salida se elige automáticamente según la interfaz de destino (consulte Salida) y no se puede configurar en openclaw.json.

Voces

Nombre	Id. de voz
Arthur	`3jUdJyOi9pgbxBTK`
Christina	`2H4HY2CBNyJHBCrP`
Emma (predeterminada)	`YTpq7expH9539ERJ`
John	`KWJiFWu2O9nMPYcR`
Kent	`LFZvm12tW_z0xfGo`
Sydney	`jtEKaLYNn6iif5PR`
Tiffany	`Eu9iL_CYe8N-Gkx_`

Sustitución de voz por mensaje

Cuando la política de voz activa permite sustituir la voz, cambie de voz en línea mediante un token de directiva (todos los siguientes son equivalentes y aceptan un id. de voz nativo del proveedor):

text

/voice:LFZvm12tW_z0xfGo/voice_id:LFZvm12tW_z0xfGo/voiceid:LFZvm12tW_z0xfGo/gradium_voice:LFZvm12tW_z0xfGo/gradiumvoice:LFZvm12tW_z0xfGo

Si la política de voz desactiva la sustitución de voz, la directiva se consume, pero se ignora.

Salida

El formato de salida se selecciona según la interfaz de destino; el proveedor no sintetiza otros formatos.

Destino	Formato	Extensión de archivo	Frecuencia de muestreo	Indicador de compatibilidad con voz
Audio estándar	`wav`	`.wav`	proveedor	no
Nota de voz	`opus`	`.opus`	proveedor	sí
Telefonía	`ulaw_8000`	n/d	8 kHz	n/d

Orden de selección automática

Entre los proveedores de TTS configurados, el orden de selección automática de Gradium es 30. Consulte Texto a voz para saber cómo OpenClaw elige el proveedor activo cuando messages.tts.provider no está fijado.

Contenido relacionado

Was this useful?