Providers

Gradium

Gradium ist ein gebündelter Text-to-Speech-Provider für OpenClaw. Das Plugin kann normale Audioantworten (WAV), mit Sprachnotizen kompatible Opus-Ausgabe und 8-kHz-u-law-Audio für Telefonie-Oberflächen erzeugen.

Eigenschaft	Wert
Provider-ID	`gradium`
Authentifizierung	`GRADIUM_API_KEY` oder Konfiguration `apiKey`
Basis-URL	`https://api.gradium.ai` (Standard)
Standardstimme	`Emma` (`YTpq7expH9539ERJ`)

Einrichtung

Erstellen Sie einen Gradium-API-Schlüssel und stellen Sie ihn OpenClaw dann entweder über eine Umgebungsvariable oder den Konfigurationsschlüssel bereit.

Umgebungsvariable

bash

export GRADIUM_API_KEY="gsk_..."

Konfigurationsschlüssel

json5

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

Das Plugin prüft zuerst den aufgelösten apiKey und fällt auf die Umgebungsvariable GRADIUM_API_KEY zurück.

Konfiguration

json5

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

Schlüssel	Typ	Beschreibung
`messages.tts.providers.gradium.apiKey`	string	Aufgelöster API-Schlüssel. Unterstützt `${ENV}` und Secret-Referenzen.
`messages.tts.providers.gradium.baseUrl`	string	Überschreibt den API-Ursprung. Abschließende Schrägstriche werden entfernt. Standard ist `https://api.gradium.ai`.
`messages.tts.providers.gradium.voiceId`	string	Standardstimmen-ID, die verwendet wird, wenn keine Direktivenüberschreibung vorhanden ist.

Das Ausgabeaudioformat wird von der Runtime automatisch basierend auf der Zieloberfläche ausgewählt und ist nicht über openclaw.json konfigurierbar. Siehe unten Ausgabe.

Stimmen

Name	Stimmen-ID
Emma	`YTpq7expH9539ERJ`
Kent	`LFZvm12tW_z0xfGo`
Tiffany	`Eu9iL_CYe8N-Gkx_`
Christina	`2H4HY2CBNyJHBCrP`
Sydney	`jtEKaLYNn6iif5PR`
John	`KWJiFWu2O9nMPYcR`
Arthur	`3jUdJyOi9pgbxBTK`

Standardstimme: Emma.

Stimmenüberschreibung pro Nachricht

Wenn die aktive Sprachrichtlinie Stimmenüberschreibungen erlaubt, können Sie Stimmen inline mit einem Direktiven-Token wechseln. Alle diese Angaben werden zur selben voiceId-Überschreibung aufgelöst:

text

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

Wenn die Sprachrichtlinie Stimmenüberschreibungen deaktiviert, wird die Direktive verbraucht, aber ignoriert.

Ausgabe

Die Runtime wählt das Ausgabeformat anhand der Zieloberfläche aus. Der Provider erzeugt derzeit keine anderen Formate.

Ziel	Format	Dateiendung	Abtastrate	Mit Stimme kompatibles Flag
Standardaudio	`wav`	`.wav`	Provider	nein
Sprachnotiz	`opus`	`.opus`	Provider	ja
Telefonie	`ulaw_8000`	n/a	8 kHz	n/a

Reihenfolge der automatischen Auswahl

Unter den konfigurierten TTS-Providern hat Gradium die automatische Auswahlreihenfolge 30. Unter Text-to-Speech erfahren Sie, wie OpenClaw den aktiven Provider auswählt, wenn messages.tts.provider nicht festgelegt ist.