Providers

Gradium

Gradium è un provider di sintesi vocale per OpenClaw. Il Plugin può generare normali risposte audio (WAV), output Opus compatibile con i messaggi vocali e audio u-law a 8 kHz per superfici di telefonia.

Proprietà	Valore
ID provider	`gradium`
Autenticazione	`GRADIUM_API_KEY` o config `apiKey`
URL base	`https://api.gradium.ai` (predefinito)
Voce predefinita	`Emma` (`YTpq7expH9539ERJ`)

Installa Plugin

Installa il Plugin ufficiale, quindi riavvia Gateway:

bash

openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

Configurazione

Crea una chiave API Gradium, quindi esponila a OpenClaw con una variabile d'ambiente o con la chiave di configurazione.

Variabile d'ambiente

bash

export GRADIUM_API_KEY="gsk_..."

Chiave di configurazione

json5

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

Il Plugin controlla prima la apiKey risolta e, in caso contrario, usa la variabile d'ambiente GRADIUM_API_KEY.

Config

json5

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

Chiave	Tipo	Descrizione
`messages.tts.providers.gradium.apiKey`	string	Chiave API risolta. Supporta `${ENV}` e riferimenti a segreti.
`messages.tts.providers.gradium.baseUrl`	string	Sostituisce l'origine API. Le barre finali vengono rimosse. Valore predefinito: `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	string	ID voce predefinito usato quando non è presente alcuna direttiva di override.

Il formato audio di output viene selezionato automaticamente dal runtime in base alla superficie di destinazione e non è configurabile da openclaw.json. Vedi Output sotto.

Voci

Nome	ID voce
Emma	`YTpq7expH9539ERJ`
Kent	`LFZvm12tW_z0xfGo`
Tiffany	`Eu9iL_CYe8N-Gkx_`
Christina	`2H4HY2CBNyJHBCrP`
Sydney	`jtEKaLYNn6iif5PR`
John	`KWJiFWu2O9nMPYcR`
Arthur	`3jUdJyOi9pgbxBTK`

Voce predefinita: Emma.

Override della voce per messaggio

Quando la policy vocale attiva consente gli override della voce, puoi cambiare voce inline usando un token direttiva. Usa speakerVoiceId per gli ID voce nativi del provider.

text

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

Se la policy vocale disabilita gli override della voce, la direttiva viene consumata ma ignorata.

Output

Il runtime sceglie il formato di output dalla superficie di destinazione. Al momento il provider non sintetizza altri formati.

Destinazione	Formato	Estensione file	Frequenza di campionamento	Flag compatibile con messaggio vocale
Audio standard	`wav`	`.wav`	provider	no
Messaggio vocale	`opus`	`.opus`	provider	sì
Telefonia	`ulaw_8000`	n/d	8 kHz	n/d

Ordine di selezione automatica

Tra i provider TTS configurati, l'ordine di selezione automatica di Gradium è 30. Vedi Sintesi vocale per sapere come OpenClaw sceglie il provider attivo quando messages.tts.provider non è fissato.

Correlati

Was this useful?