Providers
Gradium
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 dostawcy | gradium |
| Uwierzytelnianie | GRADIUM_API_KEY lub konfiguracja apiKey |
| Bazowy URL | https://api.gradium.ai (domyślnie) |
| Domyślny głos | Emma (YTpq7expH9539ERJ) |
Zainstaluj Plugin
Zainstaluj oficjalny Plugin, a następnie zrestartuj Gateway:
openclaw plugins install @openclaw/gradium-speechopenclaw gateway restartKonfiguracja
Utwórz klucz API Gradium, a następnie udostępnij go OpenClaw za pomocą zmiennej środowiskowej albo klucza konfiguracji.
Zmienna środowiskowa
export GRADIUM_API_KEY="gsk_..."Klucz konfiguracji
{ messages: { tts: { auto: "always", provider: "gradium", providers: { gradium: { apiKey: "${GRADIUM_API_KEY}", }, }, }, },}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", }, }, }, },}| Klucz | Typ | Opis |
|---|---|---|
messages.tts.providers.gradium.apiKey |
string | Rozpoznany klucz API. Obsługuje ${ENV} i odwołania do sekretów. |
messages.tts.providers.gradium.baseUrl |
string | Nadpisuje origin API. Końcowe ukośniki są usuwane. Domyślnie https://api.gradium.ai. |
messages.tts.providers.gradium.speakerVoiceId |
string | Domyś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
| Nazwa | Identyfikator głosu |
|---|---|
| Emma | YTpq7expH9539ERJ |
| Kent | LFZvm12tW_z0xfGo |
| Tiffany | Eu9iL_CYe8N-Gkx_ |
| Christina | 2H4HY2CBNyJHBCrP |
| Sydney | jtEKaLYNn6iif5PR |
| John | KWJiFWu2O9nMPYcR |
| Arthur | 3jUdJyOi9pgbxBTK |
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_z0xfGoJeś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.
| Cel | Format | Rozszerzenie pliku | Częstotliwość próbkowania | Flaga zgodności z głosem |
|---|---|---|---|---|
| Standardowy dźwięk | wav |
.wav |
dostawca | nie |
| Notatka głosowa | opus |
.opus |
dostawca | tak |
| Telefonia | ulaw_8000 |
n/d | 8 kHz | n/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.