Providers

Gradium

Gradium es un proveedor de conversión 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 configuración `apiKey`
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 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

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

Configuración

json5

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

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

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, cámbiela en línea mediante un token de directiva (todas estas formas 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 deshabilita 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 Conversión de texto a voz para saber cómo OpenClaw elige el proveedor activo cuando tts.provider no está fijado.

Temas relacionados

Was this useful?