Providers

Inworld

Inworld adalah penyedia text-to-speech (TTS) streaming. Di OpenClaw, Inworld menyintesis audio balasan keluar (MP3 secara default, OGG_OPUS untuk pesan suara) dan audio PCM mentah untuk saluran telepon seperti Voice Call.

OpenClaw mengirimkan permintaan ke endpoint TTS streaming Inworld, menggabungkan potongan audio base64 yang dikembalikan menjadi satu buffer, lalu menyerahkan hasilnya ke pipeline audio balasan standar.

Properti	Nilai
ID penyedia	`inworld`
Plugin	paket eksternal resmi (`@openclaw/inworld-speech`)
Kontrak	`speechProviders` (hanya TTS)
Variabel autentikasi	`INWORLD_API_KEY` (HTTP Basic, kredensial dasbor Base64)
URL dasar	`https://api.inworld.ai`
Suara default	`Sarah`
Model default	`inworld-tts-1.5-max`
Keluaran	MP3 (default), OGG_OPUS (pesan suara), PCM 22050 Hz (telepon)
Situs web	inworld.ai
Dokumentasi	docs.inworld.ai/tts/tts

Instal Plugin

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

Memulai

Tetapkan kunci API Anda

Salin kredensial dari dasbor Inworld Anda (Workspace > API Keys) dan tetapkan sebagai variabel lingkungan. Nilainya dikirim apa adanya sebagai kredensial HTTP Basic, jadi jangan mengodekannya lagi dengan Base64 atau mengubahnya menjadi token bearer.

bash

INWORLD_API_KEY=<base64-credential-from-dashboard>

Pilih Inworld di messages.tts

json5

{  messages: {    tts: {      auto: "always",      provider: "inworld",      providers: {        inworld: {          voiceId: "Sarah",          modelId: "inworld-tts-1.5-max",        },      },    },  },}

Kirim pesan

Kirim balasan melalui saluran apa pun yang terhubung. OpenClaw menyintesis audio dengan Inworld dan mengirimkannya sebagai MP3 (atau OGG_OPUS ketika saluran mengharapkan pesan suara).

Opsi konfigurasi

Opsi	Jalur	Deskripsi
`apiKey`	`messages.tts.providers.inworld.apiKey`	Kredensial dasbor Base64. Menggunakan `INWORLD_API_KEY` sebagai cadangan.
`baseUrl`	`messages.tts.providers.inworld.baseUrl`	Ganti URL dasar API Inworld (default `https://api.inworld.ai`).
`voiceId`	`messages.tts.providers.inworld.voiceId`	Pengidentifikasi suara (default `Sarah`). Alias lama: `speakerVoiceId`.
`modelId`	`messages.tts.providers.inworld.modelId`	ID model TTS (default `inworld-tts-1.5-max`).
`temperature`	`messages.tts.providers.inworld.temperature`	Suhu sampling, lebih dari `0` hingga `2` (opsional).

Catatan

Autentikasi

Inworld menggunakan autentikasi HTTP Basic dengan satu string kredensial yang dikodekan dalam Base64. Salin apa adanya dari dasbor Inworld. Penyedia mengirimkannya sebagai Authorization: Basic <apiKey> tanpa pengodean lebih lanjut, jadi jangan mengodekannya sendiri dengan Base64 dan jangan memberikan token bergaya bearer. Lihat catatan autentikasi TTS untuk peringatan yang sama.

Model

ID model yang didukung: inworld-tts-1.5-max (default), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.

Keluaran audio

Balasan menggunakan MP3 secara default. Ketika target saluran adalah voice-note, OpenClaw meminta OGG_OPUS dari Inworld agar audio diputar sebagai gelembung pesan suara asli. Sintesis telepon menggunakan PCM mentah pada 22050 Hz untuk memasok audio ke penghubung telepon.

Endpoint khusus

Ganti host API dengan messages.tts.providers.inworld.baseUrl. Garis miring di akhir akan dihapus sebelum permintaan dikirim.