Providers

Gradium

Gradium is een meegeleverde tekst-naar-spraakprovider voor OpenClaw. De plugin kan normale audioreacties (WAV), met spraaknotities compatibele Opus-uitvoer en 8 kHz u-law-audio voor telefonie-oppervlakken renderen.

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

Instellen

Maak een Gradium API-sleutel aan en stel die vervolgens beschikbaar aan OpenClaw met een env-var of de config-sleutel.

Env-var

bash

export GRADIUM_API_KEY="gsk_..."

Config-sleutel

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.

Config

json5

{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          voiceId: "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 geheime refs.
`messages.tts.providers.gradium.baseUrl`	string	Overschrijft de API-origin. Afsluitende slashes worden verwijderd. Standaard `https://api.gradium.ai`.
`messages.tts.providers.gradium.voiceId`	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.

Stemoverschrijving per bericht

Wanneer het actieve spraakbeleid stemoverschrijvingen toestaat, kun je inline van stem wisselen met een directive-token. Al deze tokens worden opgelost naar dezelfde voiceId-overschrijving:

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 verbruikt 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

Onder geconfigureerde TTS-providers is Gradiums volgorde voor automatische selectie 30. Zie Tekst-naar-spraak voor hoe OpenClaw de actieve provider kiest wanneer messages.tts.provider niet is vastgezet.

Gerelateerd

Was this useful?