Providers

Gradium

Gradium ist ein Text-to-Speech-Provider für OpenClaw. Er erzeugt standardmäßige Audioantworten (WAV), mit Sprachnachrichten kompatible Opus-Ausgaben und 8-kHz-u-law-Audio für Telefonie-Oberflächen.

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

Plugin installieren

Gradium ist ein offizielles externes Plugin. Installieren Sie es und starten Sie anschließend den Gateway neu:

bash

openclaw plugins install @openclaw/gradium-speechopenclaw gateway restart

Einrichtung

Erstellen Sie einen Gradium-API-Schlüssel und stellen Sie ihn anschließend über eine Umgebungsvariable oder den Konfigurationsschlüssel bereit. Die Konfiguration hat Vorrang vor der Umgebungsvariable.

Umgebungsvariable

bash

export GRADIUM_API_KEY="gsk_..."

Konfigurationsschlüssel

json5

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

Konfiguration

json5

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

Schlüssel	Typ	Beschreibung
`tts.providers.gradium.apiKey`	string	Aufgelöster API-Schlüssel. Unterstützt `${ENV}` und Geheimnisreferenzen.
`tts.providers.gradium.baseUrl`	string	HTTPS-URL der Gradium-API unter `api.gradium.ai`. Nachgestellte Schrägstriche werden entfernt. Standard: `https://api.gradium.ai`.
`tts.providers.gradium.speakerVoiceId`	string	Standardmäßige Stimmen-ID, die verwendet wird, wenn keine Überschreibung durch eine Direktive vorhanden ist.

Das Ausgabeformat wird automatisch anhand der Zieloberfläche ausgewählt (siehe Ausgabe) und kann in openclaw.json nicht konfiguriert werden.

Stimmen

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

Stimme pro Nachricht überschreiben

Wenn die aktive Sprachausgaberichtlinie das Überschreiben von Stimmen erlaubt, wechseln Sie die Stimme direkt im Text mit einem Direktiven-Token (alle folgenden Varianten sind gleichwertig und erwarten eine providerspezifische Stimmen-ID):

text

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

Wenn die Sprachausgaberichtlinie das Überschreiben von Stimmen deaktiviert, wird die Direktive verarbeitet, aber ignoriert.

Ausgabe

Das Ausgabeformat wird anhand der Zieloberfläche ausgewählt; der Provider synthetisiert keine anderen Formate.

Ziel	Format	Dateiendung	Abtastrate	Sprachnachrichten-kompatibles Flag
Standardaudio	`wav`	`.wav`	Provider	nein
Sprachnachricht	`opus`	`.opus`	Provider	ja
Telefonie	`ulaw_8000`	k. A.	8 kHz	k. 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 tts.provider nicht festgelegt ist.