Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

Instellen

Maak een Gradium API-sleutel aan en stel die vervolgens beschikbaar aan OpenClaw met een env-var of de config-sleutel.
export GRADIUM_API_KEY="gsk_..."
De plugin controleert eerst de opgeloste apiKey en valt terug op de omgevingsvariabele GRADIUM_API_KEY.

Config

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

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:
/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.
DoelIndelingBestandsextensieSamplefrequentieSpraakcompatibele vlag
Standaardaudiowav.wavprovidernee
Spraaknotitieopus.opusproviderja
Telefonieulaw_8000n.v.t.8 kHzn.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