Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Gradium adalah penyedia teks-ke-ucapan bawaan untuk OpenClaw. Plugin dapat merender balasan audio normal (WAV), output Opus yang kompatibel dengan catatan suara, dan audio u-law 8 kHz untuk permukaan telepon.
PropertiNilai
ID penyediagradium
AutentikasiGRADIUM_API_KEY atau config apiKey
URL dasarhttps://api.gradium.ai (default)
Suara defaultEmma (YTpq7expH9539ERJ)

​
Penyiapan

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

​
Config

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

​
Suara

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

​
Penggantian suara per pesan

Saat kebijakan ucapan aktif mengizinkan penggantian suara, Anda dapat mengganti suara secara inline menggunakan token direktif. Semua ini di-resolve ke penggantian voiceId yang sama: 
/voice:LFZvm12tW_z0xfGo
/voice_id:LFZvm12tW_z0xfGo
/voiceid:LFZvm12tW_z0xfGo
/gradium_voice:LFZvm12tW_z0xfGo
/gradiumvoice:LFZvm12tW_z0xfGo
Jika kebijakan ucapan menonaktifkan penggantian suara, direktif akan dikonsumsi tetapi diabaikan.

​
Output

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

​
Urutan pemilihan otomatis

Di antara penyedia TTS yang dikonfigurasi, urutan pemilihan otomatis Gradium adalah 30. Lihat Teks-ke-Ucapan untuk mengetahui cara OpenClaw memilih penyedia aktif saat messages.tts.provider tidak dipin.

​
Terkait