Zum Hauptinhalt springen

Documentation Index

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

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

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.
EigenschaftWert
Provider-IDgradium
AuthentifizierungGRADIUM_API_KEY oder Konfiguration apiKey
Basis-URLhttps://api.gradium.ai (Standard)
StandardstimmeEmma (YTpq7expH9539ERJ)

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: {
          voiceId: "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-Referenzen.
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.voiceIdstringStandardstimmen-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

NameStimmen-ID
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
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:
/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.
ZielFormatDateiendungAbtastrateMit Stimme 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