Gradium

Gradium, OpenClaw için bir metinden konuşmaya sağlayıcısıdır. Standart sesli yanıtlar (WAV), sesli notlarla uyumlu Opus çıktısı ve telefon arayüzleri için 8 kHz u-law ses üretir.

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

Plugin’i yükleme

Gradium, resmî bir harici Plugin’dir. 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 ortam değişkeni veya yapılandırma anahtarıyla kullanıma açın. Yapılandırma, ortam değişkenine göre önceliklidir.

Ortam değişkeni
Yapılandırma anahtarı

export GRADIUM_API_KEY="gsk_..."

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

Yapılandırma

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

Anahtar	Tür	Açıklama
`tts.providers.gradium.apiKey`	dize	Çözümlenmiş API anahtarı. `${ENV}` ve gizli bilgi referanslarını destekler.
`tts.providers.gradium.baseUrl`	dize	`api.gradium.ai` üzerindeki HTTPS Gradium API URL’si. Sondaki eğik çizgiler kaldırılır. Varsayılan: `https://api.gradium.ai`.
`tts.providers.gradium.speakerVoiceId`	dize	Direktifle geçersiz kılma belirtilmediğinde kullanılan varsayılan ses kimliği.

Çıktı biçimi hedef arayüze göre otomatik olarak seçilir (bkz. Çıktı) ve openclaw.json içinde yapılandırılamaz.

Sesler

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

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

Etkin konuşma ilkesi sesin geçersiz kılınmasına izin verdiğinde, bir direktif belirteciyle satır içinde sesler arasında geçiş yapın (bunların tümü eşdeğerdir ve sağlayıcıya özgü bir ses kimliği alır):

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

Konuşma ilkesi sesin geçersiz kılınmasını devre dışı bırakırsa direktif işlenir ancak yok sayılır.

Çıktı

Çıktı biçimi hedef arayüze göre seçilir; sağlayıcı başka biçimler üretmez.

Hedef	Biçim	Dosya uzantısı	Örnekleme hızı	Sesle uyumluluk işareti
Standart ses	`wav`	`.wav`	sağlayıcı	hayır
Sesli not	`opus`	`.opus`	sağlayıcı	evet
Telefon	`ulaw_8000`	yok	8 kHz	yok

Otomatik seçim sırası

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

Overview

Concepts and configuration

Providers

Plugin’i yükleme

Kurulum

Yapılandırma

Sesler

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

Çıktı

Otomatik seçim sırası

İlgili

​Plugin’i yükleme

​Kurulum

​Yapılandırma

​Sesler

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

​Çıktı

​Otomatik seçim sırası

​İlgili

Plugin’i yükleme

Kurulum

Yapılandırma

Sesler

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

Çıktı

Otomatik seçim sırası

İlgili