Przejdź do głównej treści
Gradium jest dostawcą zamiany tekstu na mowę dla OpenClaw. Plugin może renderować zwykłe odpowiedzi audio (WAV), wyjście Opus zgodne z notatkami głosowymi oraz dźwięk u-law 8 kHz dla powierzchni telefonicznych.
WłaściwośćWartość
Identyfikator dostawcygradium
UwierzytelnianieGRADIUM_API_KEY lub konfiguracja apiKey
Bazowy URLhttps://api.gradium.ai (domyślnie)
Domyślny głosEmma (YTpq7expH9539ERJ)

​
Zainstaluj Plugin

Zainstaluj oficjalny Plugin, a następnie zrestartuj Gateway: 
openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

​
Konfiguracja

Utwórz klucz API Gradium, a następnie udostępnij go OpenClaw za pomocą zmiennej środowiskowej albo klucza konfiguracji. 
export GRADIUM_API_KEY="gsk_..."
Plugin najpierw sprawdza rozpoznany apiKey, a następnie wraca do zmiennej środowiskowej GRADIUM_API_KEY.

​
Konfiguracja

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
KluczTypOpis
messages.tts.providers.gradium.apiKeystringRozpoznany klucz API. Obsługuje ${ENV} i odwołania do sekretów.
messages.tts.providers.gradium.baseUrlstringNadpisuje origin API. Końcowe ukośniki są usuwane. Domyślnie https://api.gradium.ai.
messages.tts.providers.gradium.speakerVoiceIdstringDomyślny identyfikator głosu używany, gdy nie ma nadpisania dyrektywą.
Format wyjściowego dźwięku jest wybierany automatycznie przez runtime na podstawie docelowej powierzchni i nie można go skonfigurować w openclaw.json. Zobacz Wyjście poniżej.

​
Głosy

NazwaIdentyfikator głosu
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
Domyślny głos: Emma.

​
Nadpisanie głosu dla pojedynczej wiadomości

Gdy aktywna polityka mowy zezwala na nadpisania głosu, możesz przełączać głosy w treści za pomocą tokenu dyrektywy. Użyj speakerVoiceId dla natywnych identyfikatorów głosu dostawcy. 
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
Jeśli polityka mowy wyłącza nadpisania głosu, dyrektywa zostaje przetworzona, ale zignorowana.

​
Wyjście

Runtime wybiera format wyjściowy na podstawie docelowej powierzchni. Dostawca obecnie nie syntetyzuje innych formatów.
CelFormatRozszerzenie plikuCzęstotliwość próbkowaniaFlaga zgodności z głosem
Standardowy dźwiękwav.wavdostawcanie
Notatka głosowaopus.opusdostawcatak
Telefoniaulaw_8000n/d8 kHzn/d

​
Kolejność automatycznego wyboru

Wśród skonfigurowanych dostawców TTS kolejność automatycznego wyboru Gradium to 30. Zobacz Zamiana tekstu na mowę, aby dowiedzieć się, jak OpenClaw wybiera aktywnego dostawcę, gdy messages.tts.provider nie jest przypięty.

​
Powiązane