Providers
Gradium
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-speechopenclaw gateway restartKurulum
Bir Gradium API anahtarı oluşturun, ardından bunu bir env var veya config anahtarıyla OpenClaw'a sunun.
Env var
export GRADIUM_API_KEY="gsk_..."Config key
{ 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_z0xfGoKonuş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.