Gradium

Gradium to dostawca zamiany tekstu na mowę dla OpenClaw. Generuje standardowe odpowiedzi dźwiękowe (WAV), dane wyjściowe Opus zgodne z wiadomościami głosowymi oraz dźwięk u-law 8 kHz dla interfejsów telefonicznych.

Właściwość	Wartość
Identyfikator dostawcy	`gradium`
Uwierzytelnianie	`GRADIUM_API_KEY` lub konfiguracja `apiKey`
Bazowy adres URL	`https://api.gradium.ai` (domyślnie)
Domyślny głos	`Emma` (`YTpq7expH9539ERJ`)

Instalacja pluginu

Gradium jest oficjalnym zewnętrznym pluginem. Zainstaluj go, a następnie uruchom ponownie Gateway:

openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

Konfiguracja początkowa

Utwórz klucz API Gradium, a następnie udostępnij go za pomocą zmiennej środowiskowej lub klucza konfiguracji. Konfiguracja ma pierwszeństwo przed zmienną środowiskową.

Zmienna środowiskowa
Klucz konfiguracji

export GRADIUM_API_KEY="gsk_..."

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          apiKey: "${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`	ciąg znaków	Rozpoznany klucz API. Obsługuje `${ENV}` oraz odwołania do sekretów.
`messages.tts.providers.gradium.baseUrl`	ciąg znaków	Adres URL HTTPS interfejsu API Gradium w `api.gradium.ai`. Końcowe ukośniki są usuwane. Wartość domyślna: `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	ciąg znaków	Domyślny identyfikator głosu używany, gdy dyrektywa nie określa innej wartości.

Format wyjściowy jest wybierany automatycznie na podstawie interfejsu docelowego (zobacz Dane wyjściowe) i nie można go skonfigurować w openclaw.json.

Głosy

Nazwa	Identyfikator głosu
Arthur	`3jUdJyOi9pgbxBTK`
Christina	`2H4HY2CBNyJHBCrP`
Emma (domyślnie)	`YTpq7expH9539ERJ`
John	`KWJiFWu2O9nMPYcR`
Kent	`LFZvm12tW_z0xfGo`
Sydney	`jtEKaLYNn6iif5PR`
Tiffany	`Eu9iL_CYe8N-Gkx_`

Zmiana głosu dla poszczególnych wiadomości

Gdy aktywna polityka mowy zezwala na zmianę głosu, można zmienić głos bezpośrednio w treści za pomocą tokenu dyrektywy (wszystkie poniższe formy są równoważne i przyjmują natywny dla dostawcy identyfikator głosu):

/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo

Jeśli polityka mowy wyłącza zmianę głosu, dyrektywa jest przetwarzana, ale ignorowana.

Dane wyjściowe

Format wyjściowy jest wybierany na podstawie interfejsu docelowego; dostawca nie generuje innych formatów.

Cel	Format	Rozszerzenie pliku	Częstotliwość próbkowania	Flaga zgodności z wiadomościami głosowymi
Standardowy dźwięk	`wav`	`.wav`	dostawca	nie
Wiadomość głosowa	`opus`	`.opus`	dostawca	tak
Telefonia	`ulaw_8000`	nie dotyczy	8 kHz	nie dotyczy

Kolejność automatycznego wyboru

Wśród skonfigurowanych dostawców TTS pozycja Gradium w kolejności automatycznego wyboru to 30. Informacje o tym, jak OpenClaw wybiera aktywnego dostawcę, gdy messages.tts.provider nie jest przypięty, znajdują się w sekcji Zamiana tekstu na mowę.

Overview

Concepts and configuration

Providers

Instalacja pluginu

Konfiguracja początkowa

Konfiguracja

Głosy

Zmiana głosu dla poszczególnych wiadomości

Dane wyjściowe

Kolejność automatycznego wyboru

Powiązane materiały

​Instalacja pluginu

​Konfiguracja początkowa

​Konfiguracja

​Głosy

​Zmiana głosu dla poszczególnych wiadomości

​Dane wyjściowe

​Kolejność automatycznego wyboru

​Powiązane materiały

Instalacja pluginu

Konfiguracja początkowa

Konfiguracja

Głosy

Zmiana głosu dla poszczególnych wiadomości

Dane wyjściowe

Kolejność automatycznego wyboru

Powiązane materiały