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 Telefonieoberflä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 das 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

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

Konfiguration

json5

{  messages: {    tts: {      auto: "always",      provider: "gradium",      providers: {        gradium: {          speakerVoiceId: "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 Geheimnisreferenzen.
`messages.tts.providers.gradium.baseUrl`	string	HTTPS-URL der Gradium-API auf `api.gradium.ai`. Abschließende Schrägstriche werden entfernt. Standard: `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	string	Standardmäßige Stimmen-ID, die verwendet wird, wenn keine Überschreibung per Direktive vorhanden ist.

Das Ausgabeformat wird automatisch anhand der Zieloberfläche ausgewählt (siehe Ausgabe) und kann nicht in openclaw.json 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 Sprachrichtlinie das Überschreiben der Stimme zulässt, können Sie die Stimme direkt mit einem Direktiven-Token wechseln (alle folgenden Varianten sind gleichwertig und erwarten eine native Stimmen-ID des Providers):

text

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

Wenn die Sprachrichtlinie das Überschreiben der Stimme 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	Mit Sprache kompatibles Kennzeichen
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 bei der automatischen Auswahl die Reihenfolge 30. Unter Text-to-Speech erfahren Sie, wie OpenClaw den aktiven Provider auswählt, wenn messages.tts.provider nicht festgelegt ist.