Inworld - OpenClaw

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

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

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

Установіть офіційний Plugin, а потім перезапустіть Gateway:

openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart

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

Установіть свій API-ключ

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

INWORLD_API_KEY=<base64-credential-from-dashboard>

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

{
  messages: {
    tts: {
      auto: "always",
      provider: "inworld",
      providers: {
        inworld: {
          speakerVoiceId: "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`).
`speakerVoiceId`	`messages.tts.providers.inworld.speakerVoiceId`	Ідентифікатор голосу (за замовчуванням `Sarah`).
`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 Hz для передавання в телефонний міст.

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

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

Пов’язане

Перетворення тексту на мовлення

Огляд TTS, провайдери та конфігурація messages.tts.

Конфігурація

Повний довідник конфігурації, включно з налаштуваннями messages.tts.

Провайдери

Усі підтримувані провайдери OpenClaw.

Усунення несправностей

Поширені проблеми та кроки налагодження.

​Установлення Plugin

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

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

​Примітки

​Пов’язане