Vai al contenuto principale
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 providergradium
AutenticazioneGRADIUM_API_KEY o config apiKey
URL basehttps://api.gradium.ai (predefinito)
Voce predefinitaEmma (YTpq7expH9539ERJ)

​
Installa Plugin

Installa il Plugin ufficiale, quindi riavvia Gateway: 
openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

​
Configurazione

Crea una chiave API Gradium, quindi esponila a OpenClaw con una variabile d’ambiente o con la chiave di configurazione. 
export GRADIUM_API_KEY="gsk_..."
Il Plugin controlla prima la apiKey risolta e, in caso contrario, usa la variabile d’ambiente GRADIUM_API_KEY.

​
Config

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
ChiaveTipoDescrizione
messages.tts.providers.gradium.apiKeystringChiave API risolta. Supporta ${ENV} e riferimenti a segreti.
messages.tts.providers.gradium.baseUrlstringSostituisce l’origine API. Le barre finali vengono rimosse. Valore predefinito: https://api.gradium.ai.
messages.tts.providers.gradium.speakerVoiceIdstringID 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

NomeID voce
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
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. 
/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.
DestinazioneFormatoEstensione fileFrequenza di campionamentoFlag compatibile con messaggio vocale
Audio standardwav.wavproviderno
Messaggio vocaleopus.opusprovidersì
Telefoniaulaw_8000n/d8 kHzn/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