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:

openclaw plugins install @openclaw/gradium-speech
openclaw 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
Configuratiesleutel

export GRADIUM_API_KEY="gsk_..."

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

Configuratie

{
  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):

/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.

Overview

Concepts and configuration

Providers

Plugin installeren

Instellen

Configuratie

Stemmen

Stem per bericht overschrijven

Uitvoer

Automatische selectievolgorde

Gerelateerd

​Plugin installeren

​Instellen

​Configuratie

​Stemmen

​Stem per bericht overschrijven

​Uitvoer

​Automatische selectievolgorde

​Gerelateerd

Plugin installeren

Instellen

Configuratie

Stemmen

Stem per bericht overschrijven

Uitvoer

Automatische selectievolgorde

Gerelateerd