Przejdź do głównej treści

Documentation Index

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

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

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

Konfiguracja

Utwórz klucz API Gradium, a następnie udostępnij go OpenClaw za pomocą zmiennej środowiskowej albo klucza config.
export GRADIUM_API_KEY="gsk_..."
Plugin najpierw sprawdza rozwiązany apiKey, a w razie jego braku używa zmiennej środowiskowej GRADIUM_API_KEY.

Config

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          voiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
KluczTypOpis
messages.tts.providers.gradium.apiKeystringRozwiązany klucz API. Obsługuje ${ENV} i referencje do sekretów.
messages.tts.providers.gradium.baseUrlstringNadpisuje źródło API. Końcowe ukośniki są usuwane. Domyślnie https://api.gradium.ai.
messages.tts.providers.gradium.voiceIdstringDomyślny identyfikator głosu używany, gdy nie ma nadpisania dyrektywą.
Format wyjściowego audio jest wybierany automatycznie przez środowisko uruchomieniowe na podstawie powierzchni docelowej i nie można go konfigurować z 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 wiadomości

Gdy aktywna polityka mowy zezwala na nadpisywanie głosu, możesz przełączać głosy bezpośrednio w treści za pomocą tokenu dyrektywy. Wszystkie poniższe warianty rozwiązują się do tego samego nadpisania voiceId:
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
Jeśli polityka mowy wyłącza nadpisywanie głosu, dyrektywa jest zużywana, ale ignorowana.

Wyjście

Środowisko uruchomieniowe wybiera format wyjściowy na podstawie powierzchni docelowej. Dostawca obecnie nie syntetyzuje innych formatów.
CelFormatRozszerzenie plikuCzęstotliwość próbkowaniaFlaga zgodności z głosem
Standardowe audiowav.wavdostawcanie
Notatka głosowaopus.opusdostawcatak
Telefoniaulaw_8000n/a8 kHzn/a

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