Zum Hauptinhalt springen
Gradium ist ein 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.
EigenschaftWert
Provider-IDgradium
AuthGRADIUM_API_KEY oder config apiKey
Basis-URLhttps://api.gradium.ai (Standard)
StandardstimmeEmma (YTpq7expH9539ERJ)

​
Plugin installieren

Installieren Sie das offizielle Plugin und starten Sie dann den Gateway neu: 
openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

​
Einrichtung

Erstellen Sie einen Gradium-API-Schlüssel und stellen Sie ihn OpenClaw dann entweder über eine Umgebungsvariable oder den Konfigurationsschlüssel bereit. 
export GRADIUM_API_KEY="gsk_..."
Das Plugin prüft zuerst den aufgelösten apiKey und fällt auf die Umgebungsvariable GRADIUM_API_KEY zurück.

​
Konfiguration

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
SchlüsselTypBeschreibung
messages.tts.providers.gradium.apiKeystringAufgelöster API-Schlüssel. Unterstützt ${ENV} und secret refs.
messages.tts.providers.gradium.baseUrlstringÜberschreibt den API-Ursprung. Abschließende Schrägstriche werden entfernt. Standard ist https://api.gradium.ai.
messages.tts.providers.gradium.speakerVoiceIdstringStandard-Stimmen-ID, die verwendet wird, wenn keine Direktivenüberschreibung vorhanden ist.
Das Ausgabeaudioformat wird von der Runtime automatisch anhand der Zieloberfläche ausgewählt und ist nicht über openclaw.json konfigurierbar. Siehe Ausgabe unten.

​
Stimmen

NameStimmen-ID
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
Standardstimme: Emma.

​
Stimmüberschreibung pro Nachricht

Wenn die aktive Sprachrichtlinie Stimmüberschreibungen erlaubt, können Sie Stimmen inline mit einem Direktiven-Token wechseln. Verwenden Sie speakerVoiceId für Provider-native Stimmen-IDs. 
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
Wenn die Sprachrichtlinie Stimmüberschreibungen deaktiviert, wird die Direktive verarbeitet, aber ignoriert.

​
Ausgabe

Die Runtime wählt das Ausgabeformat anhand der Zieloberfläche aus. Der Provider synthetisiert derzeit keine anderen Formate.
ZielFormatDateiendungAbtastrateSprachnotiz-kompatibles Flag
Standardaudiowav.wavProvidernein
Sprachnotizopus.opusProviderja
Telefonieulaw_8000n/a8 kHzn/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.

​
Verwandte Themen