Langsung ke konten utama
Gradium adalah penyedia text-to-speech untuk OpenClaw. Plugin ini dapat merender balasan audio normal (WAV), keluaran Opus yang kompatibel dengan catatan suara, dan audio u-law 8 kHz untuk permukaan teleponi.
PropertiNilai
Id penyediagradium
AutentikasiGRADIUM_API_KEY atau config apiKey
URL dasarhttps://api.gradium.ai (default)
Suara defaultEmma (YTpq7expH9539ERJ)

​
Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway: 
openclaw plugins install @openclaw/gradium-speech
openclaw gateway restart

​
Penyiapan

Buat kunci API Gradium, lalu ekspos ke OpenClaw dengan variabel lingkungan atau kunci config. 
export GRADIUM_API_KEY="gsk_..."
Plugin memeriksa apiKey yang telah di-resolve terlebih dahulu dan kembali menggunakan variabel lingkungan GRADIUM_API_KEY.

​
Konfigurasi

{
  messages: {
    tts: {
      auto: "always",
      provider: "gradium",
      providers: {
        gradium: {
          speakerVoiceId: "YTpq7expH9539ERJ",
          // apiKey: "${GRADIUM_API_KEY}",
          // baseUrl: "https://api.gradium.ai",
        },
      },
    },
  },
}
KunciJenisDeskripsi
messages.tts.providers.gradium.apiKeystringKunci API yang telah di-resolve. Mendukung ${ENV} dan referensi rahasia.
messages.tts.providers.gradium.baseUrlstringMengganti origin API. Garis miring di akhir akan dihapus. Default ke https://api.gradium.ai.
messages.tts.providers.gradium.speakerVoiceIdstringId suara default yang digunakan saat tidak ada penggantian direktif.
Format audio keluaran dipilih otomatis oleh runtime berdasarkan permukaan target dan tidak dapat dikonfigurasi dari openclaw.json. Lihat Keluaran di bawah.

​
Suara

NamaID Suara
EmmaYTpq7expH9539ERJ
KentLFZvm12tW_z0xfGo
TiffanyEu9iL_CYe8N-Gkx_
Christina2H4HY2CBNyJHBCrP
SydneyjtEKaLYNn6iif5PR
JohnKWJiFWu2O9nMPYcR
Arthur3jUdJyOi9pgbxBTK
Suara default: Emma.

​
Penimpaan suara per pesan

Ketika kebijakan ucapan aktif mengizinkan penimpaan suara, Anda dapat mengganti suara secara inline menggunakan token direktif. Gunakan speakerVoiceId untuk ID suara native penyedia. 
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
Jika kebijakan ucapan menonaktifkan penimpaan suara, direktif tersebut diproses tetapi diabaikan.

​
Keluaran

Runtime memilih format keluaran dari permukaan target. Penyedia saat ini tidak menyintesis format lain.
TargetFormatEkstensi fileLaju sampelFlag kompatibel suara
Audio standarwav.wavpenyediatidak
Catatan suaraopus.opuspenyediaya
Telefoniulaw_8000n/a8 kHzn/a

​
Urutan pemilihan otomatis

Di antara penyedia TTS yang dikonfigurasi, urutan pemilihan otomatis Gradium adalah 30. Lihat Text-to-Speech untuk cara OpenClaw memilih penyedia aktif ketika messages.tts.provider tidak dipasangkan.

​
Terkait