Gradium - OpenClaw

Gradium, OpenClaw için bir metinden konuşmaya sağlayıcısıdır. Plugin normal sesli yanıtları (WAV), sesli not uyumlu Opus çıktısını ve telefon yüzeyleri için 8 kHz u-law sesi işleyebilir.

Özellik	Değer
Sağlayıcı kimliği	`gradium`
Kimlik doğrulama	`GRADIUM_API_KEY` veya config `apiKey`
Temel URL	`https://api.gradium.ai` (varsayılan)
Varsayılan ses	`Emma` (`YTpq7expH9539ERJ`)

Plugin yükleme

Resmi Plugin’i yükleyin, ardından Gateway’i yeniden başlatın:

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

Kurulum

Bir Gradium API anahtarı oluşturun, ardından bunu bir env var veya config anahtarıyla OpenClaw’a sunun.

Env var
Config key

export GRADIUM_API_KEY="gsk_..."

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          apiKey: "${GRADIUM_API_KEY}",
        },
      },
    },
  },
}

Plugin önce çözümlenen apiKey değerini kontrol eder ve ardından GRADIUM_API_KEY ortam değişkenine geri döner.

Config

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}

Anahtar	Tür	Açıklama
`messages.tts.providers.gradium.apiKey`	string	Çözümlenen API anahtarı. `${ENV}` ve secret ref’lerini destekler.
`messages.tts.providers.gradium.baseUrl`	string	API kaynağını geçersiz kılar. Sondaki eğik çizgiler çıkarılır. Varsayılan `https://api.gradium.ai`.
`messages.tts.providers.gradium.speakerVoiceId`	string	Yönerge geçersiz kılması yokken kullanılan varsayılan ses kimliği.

Çıktı ses biçimi, hedef yüzeye göre runtime tarafından otomatik olarak seçilir ve openclaw.json içinden yapılandırılamaz. Aşağıdaki Çıktı bölümüne bakın.

Sesler

Ad	Ses kimliği
Emma	`YTpq7expH9539ERJ`
Kent	`LFZvm12tW_z0xfGo`
Tiffany	`Eu9iL_CYe8N-Gkx_`
Christina	`2H4HY2CBNyJHBCrP`
Sydney	`jtEKaLYNn6iif5PR`
John	`KWJiFWu2O9nMPYcR`
Arthur	`3jUdJyOi9pgbxBTK`

Varsayılan ses: Emma.

Mesaj başına ses geçersiz kılma

Etkin konuşma ilkesi ses geçersiz kılmalarına izin verdiğinde, bir yönerge belirteci kullanarak sesleri satır içinde değiştirebilirsiniz. Sağlayıcıya özgü ses kimlikleri için speakerVoiceId kullanın.

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

Konuşma ilkesi ses geçersiz kılmalarını devre dışı bırakırsa, yönerge tüketilir ancak yok sayılır.

Çıktı

Runtime, çıktı biçimini hedef yüzeyden seçer. Sağlayıcı bugün başka biçimler sentezlemez.

Hedef	Biçim	Dosya uzantısı	Örnekleme hızı	Ses uyumlu bayrak
Standart ses	`wav`	`.wav`	sağlayıcı	hayır
Sesli not	`opus`	`.opus`	sağlayıcı	evet
Telefon	`ulaw_8000`	n/a	8 kHz	n/a

Otomatik seçim sırası

Yapılandırılmış TTS sağlayıcıları arasında Gradium’un otomatik seçim sırası 30 değeridir. messages.tts.provider sabitlenmediğinde OpenClaw’ın etkin sağlayıcıyı nasıl seçtiği için Metinden Konuşmaya bölümüne bakın.

​Plugin yükleme

​Kurulum

​Config

​Sesler

​Mesaj başına ses geçersiz kılma

​Çıktı

​Otomatik seçim sırası

​İlgili