Naar hoofdinhoud gaan
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.
EigenschapWaarde
Provider-idgradium
AuthenticatieGRADIUM_API_KEY of config apiKey
Basis-URLhttps://api.gradium.ai (standaard)
StandaardstemEmma (YTpq7expH9539ERJ)

​
Plugin installeren

Installeer de officiële Plugin en start daarna Gateway opnieuw: 
openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

​
Instellen

Maak een Gradium-API-sleutel en stel die daarna beschikbaar aan OpenClaw via een omgevingsvariabele of de configuratiesleutel. 
export GRADIUM_API_KEY="gsk_..."
De Plugin controleert eerst de opgeloste apiKey en valt terug op de omgevingsvariabele GRADIUM_API_KEY.

​
Configuratie

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
SleutelTypeBeschrijving
messages.tts.providers.gradium.apiKeystringOpgeloste API-sleutel. Ondersteunt ${ENV} en secret refs.
messages.tts.providers.gradium.baseUrlstringOverschrijft de API-origin. Afsluitende slashes worden verwijderd. Standaard https://api.gradium.ai.
messages.tts.providers.gradium.speakerVoiceIdstringStandaardstem-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

NaamStem-ID
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
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. 
/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.
DoelIndelingBestandsextensieSamplefrequentieSpraakcompatibele vlag
Standaardaudiowav.wavprovidernee
Spraaknotitieopus.opusproviderja
Telefonieulaw_8000n.v.t.8 kHzn.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