Documentation Index
Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Gradium è un provider di sintesi vocale incluso in OpenClaw. Il plugin può generare normali risposte audio (WAV), output Opus compatibile con note 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 di base | https://api.gradium.ai (default) |
| Voce predefinita | Emma (YTpq7expH9539ERJ) |
Configurazione
Crea una chiave API Gradium, quindi esponila a OpenClaw con una variabile d’ambiente o con la chiave di configurazione.
Variabile d'ambiente
Chiave di configurazione
export GRADIUM_API_KEY="gsk_..."
{
messages: {
tts: {
auto: "always",
provider: "gradium",
providers: {
gradium: {
apiKey: "${GRADIUM_API_KEY}",
},
},
},
},
}
apiKey risolta e, in alternativa, usa la variabile d’ambiente GRADIUM_API_KEY.
Configurazione
{
messages: {
tts: {
auto: "always",
provider: "gradium",
providers: {
gradium: {
voiceId: "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 | Sovrascrive l’origine API. Le barre finali vengono rimosse. Il valore predefinito è https://api.gradium.ai. |
messages.tts.providers.gradium.voiceId | string | ID della voce predefinita usato quando non è presente alcuna sovrascrittura tramite direttiva. |
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 |
Sovrascrittura della voce per messaggio
Quando la policy vocale attiva consente le sovrascritture della voce, puoi cambiare voce inline usando un token direttiva. Tutti questi vengono risolti nella stessa sovrascrittura di voiceId:
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
Output
Il runtime sceglie il formato di output dalla superficie di destinazione. Oggi il provider non sintetizza altri formati.
| Destinazione | Formato | Estensione file | Frequenza di campionamento | Flag compatibile con voce |
|---|
| Audio standard | wav | .wav | provider | no |
| Nota 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
