Providers

Gradium

Gradium is een tekst-naar-spraak-provider voor OpenClaw. De Plugin kan normale audioreacties (WAV), Opus-uitvoer die compatibel is met spraaknotities, en 8 kHz u-law-audio voor telefonie-oppervlakken renderen.

Eigenschap	Waarde
Provider-id	`gradium`
Authenticatie	`GRADIUM_API_KEY` of config `apiKey`
Basis-URL	`https://api.gradium.ai` (standaard)
Standaardstem	`Emma` (`YTpq7expH9539ERJ`)

Plugin installeren

Installeer de officiële Plugin en start daarna Gateway opnieuw:

bash

openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

Instellen

Maak een Gradium-API-sleutel en stel die daarna beschikbaar aan OpenClaw via een omgevingsvariabele of de configuratiesleutel.

Env var

bash

export GRADIUM_API_KEY="gsk_..."

Config key

json5

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

De Plugin controleert eerst de opgeloste apiKey en valt terug op de omgevingsvariabele GRADIUM_API_KEY.

Configuratie

json5

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

Sleutel	Type	Beschrijving
`messages.tts.providers.gradium.apiKey`	string	Opgeloste API-sleutel. Ondersteunt `${ENV}` en secret refs.
`messages.tts.providers.gradium.baseUrl`	string	Overschrijft de API-origin. Afsluitende slashes worden verwijderd. Standaard `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	string	Standaardstem-id dat wordt gebruikt wanneer er geen directive-overschrijving aanwezig is.

De uitvoeraudio-indeling wordt automatisch geselecteerd door de runtime op basis van het doeloppervlak en is niet configureerbaar vanuit openclaw.json. Zie Uitvoer hieronder.

Stemmen

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

Standaardstem: Emma.

Stem per bericht overschrijven

Wanneer het actieve spraakbeleid stemoverschrijvingen toestaat, kun je inline van stem wisselen met een directive-token. Gebruik speakerVoiceId voor provider-native stem-id's.

text

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

Als het spraakbeleid stemoverschrijvingen uitschakelt, wordt de directive verwerkt maar genegeerd.

Uitvoer

De runtime kiest de uitvoerindeling op basis van het doeloppervlak. De provider synthetiseert momenteel geen andere indelingen.

Doel	Indeling	Bestandsextensie	Samplefrequentie	Spraakcompatibele vlag
Standaardaudio	`wav`	`.wav`	provider	nee
Spraaknotitie	`opus`	`.opus`	provider	ja
Telefonie	`ulaw_8000`	n.v.t.	8 kHz	n.v.t.

Volgorde voor automatische selectie

Van de geconfigureerde TTS-providers is de automatische selectievolgorde van Gradium 30. Zie Tekst-naar-spraak voor hoe OpenClaw de actieve provider kiest wanneer messages.tts.provider niet is vastgezet.

Gerelateerd

Was this useful?