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:

openclaw plugins install @openclaw/gradium-speech
openclaw 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
Clave de configuración

export GRADIUM_API_KEY="gsk_..."

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

Configuración

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

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

Overview

Concepts and configuration

Providers

Instalar el plugin

Configuración inicial

Configuración

Voces

Sustitución de voz por mensaje

Salida

Orden de selección automática

Temas relacionados

​Instalar el plugin

​Configuración inicial

​Configuración

​Voces

​Sustitución de voz por mensaje

​Salida

​Orden de selección automática

​Temas relacionados

Instalar el plugin

Configuración inicial

Configuración

Voces

Sustitución de voz por mensaje

Salida

Orden de selección automática

Temas relacionados