Providers

Inworld

Inworld — це постачальник потокового перетворення тексту на мовлення (TTS). В OpenClaw він синтезує аудіо вихідних відповідей (типово MP3, OGG_OPUS для голосових повідомлень) і необроблене PCM-аудіо для телефонних каналів, як-от Voice Call.

OpenClaw надсилає запити до потокової кінцевої точки TTS Inworld, об’єднує повернені фрагменти аудіо у форматі base64 в єдиний буфер і передає результат стандартному конвеєру аудіовідповідей.

Властивість	Значення
Ідентифікатор постачальника	`inworld`
Plugin	офіційний зовнішній пакет (`@openclaw/inworld-speech`)
Контракт	`speechProviders` (лише TTS)
Змінна середовища автентифікації	`INWORLD_API_KEY` (HTTP Basic, облікові дані Base64 із панелі керування)
Базова URL-адреса	`https://api.inworld.ai`
Типовий голос	`Sarah`
Типова модель	`inworld-tts-1.5-max`
Вихідний формат	MP3 (типово), OGG_OPUS (голосові повідомлення), PCM 22050 Гц (телефонія)
Вебсайт	inworld.ai
Документація	docs.inworld.ai/tts/tts

Встановлення Plugin

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

Початок роботи

Задайте ключ API

Скопіюйте облікові дані з панелі керування Inworld (Workspace > API Keys) і задайте їх як змінну середовища. Значення надсилається без змін як облікові дані HTTP Basic, тому не кодуйте його в Base64 повторно й не перетворюйте на токен носія.

bash

INWORLD_API_KEY=<base64-credential-from-dashboard>

Виберіть Inworld у messages.tts

json5

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

Надішліть повідомлення

Надішліть відповідь через будь-який підключений канал. OpenClaw синтезує аудіо за допомогою Inworld і доставить його у форматі MP3 (або OGG_OPUS, коли канал очікує голосове повідомлення).

Параметри конфігурації

Параметр	Шлях	Опис
`apiKey`	`messages.tts.providers.inworld.apiKey`	Облікові дані Base64 із панелі керування. Якщо не задано, використовується `INWORLD_API_KEY`.
`baseUrl`	`messages.tts.providers.inworld.baseUrl`	Перевизначає базову URL-адресу API Inworld (типово `https://api.inworld.ai`).
`voiceId`	`messages.tts.providers.inworld.voiceId`	Ідентифікатор голосу (типово `Sarah`). Застарілий псевдонім: `speakerVoiceId`.
`modelId`	`messages.tts.providers.inworld.modelId`	Ідентифікатор моделі TTS (типово `inworld-tts-1.5-max`).
`temperature`	`messages.tts.providers.inworld.temperature`	Температура вибірки: від `0` (не включно) до `2` (необов’язково).

Примітки

Автентифікація

Inworld використовує автентифікацію HTTP Basic з одним рядком облікових даних, закодованим у Base64. Скопіюйте його без змін із панелі керування Inworld. Постачальник надсилає його як Authorization: Basic <apiKey> без додаткового кодування, тому не кодуйте його в Base64 самостійно й не передавайте токен у стилі bearer. Те саме застереження наведено в примітках щодо автентифікації TTS.

Моделі

Підтримувані ідентифікатори моделей: inworld-tts-1.5-max (типово), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.

Вихідні аудіоформати

Типово для відповідей використовується MP3. Коли ціль каналу — voice-note, OpenClaw запитує в Inworld формат OGG_OPUS, щоб аудіо відтворювалося як нативна голосова бульбашка. Для телефонного синтезу використовується необроблений формат PCM із частотою 22050 Гц, який передається до телефонного мосту.

Власні кінцеві точки

Перевизначте хост API за допомогою messages.tts.providers.inworld.baseUrl. Перед надсиланням запитів кінцеві скісні риски видаляються.