Providers

Gradium

Gradium is een tekst-naar-spraakprovider voor OpenClaw. Deze levert standaard audioreacties (WAV), met spraaknotities compatibele Opus-uitvoer en 8 kHz u-law-audio voor telefonieplatforms.

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

Plugin installeren

Gradium is een officiële externe plugin. Installeer deze en start daarna de Gateway opnieuw:

bash

openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

Instellen

Maak een Gradium-API-sleutel aan en stel deze vervolgens beschikbaar via een omgevingsvariabele of de configuratiesleutel. De configuratie heeft voorrang op de omgevingsvariabele.

Omgevingsvariabele

bash

export GRADIUM_API_KEY="gsk_..."

Configuratiesleutel

json5

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

Configuratie

json5

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

Sleutel	Type	Beschrijving
`tts.providers.gradium.apiKey`	string	Omgezette API-sleutel. Ondersteunt `${ENV}` en geheime verwijzingen.
`tts.providers.gradium.baseUrl`	string	HTTPS-URL van de Gradium-API op `api.gradium.ai`. Afsluitende schuine strepen worden verwijderd. Standaard: `https://api.gradium.ai`.
`tts.providers.gradium.speakerVoiceId`	string	Standaardstem-id dat wordt gebruikt wanneer geen overschrijvende instructie aanwezig is.

De uitvoerindeling wordt automatisch gekozen op basis van het doelplatform (zie Uitvoer) en kan niet worden geconfigureerd in openclaw.json.

Stemmen

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

Stem per bericht overschrijven

Wanneer het actieve spraakbeleid het overschrijven van stemmen toestaat, kun je binnen de tekst van stem wisselen met een instructietoken (alle onderstaande varianten zijn gelijkwaardig en gebruiken een providerspecifiek stem-id):

text

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

Als het spraakbeleid het overschrijven van stemmen uitschakelt, wordt de instructie verwerkt maar genegeerd.

Uitvoer

De uitvoerindeling wordt geselecteerd op basis van het doelplatform; de provider genereert geen andere indelingen.

Doel	Indeling	Bestandsextensie	Samplesnelheid	Spraakcompatibiliteitsvlag
Standaardaudio	`wav`	`.wav`	provider	nee
Spraaknotitie	`opus`	`.opus`	provider	ja
Telefonie	`ulaw_8000`	n.v.t.	8 kHz	n.v.t.

Automatische selectievolgorde

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

Gerelateerd

Was this useful?