Providers

Inworld

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

OpenClaw отправляет запросы в потоковую конечную точку TTS Inworld, объединяет возвращенные фрагменты аудио в base64 в единый буфер и передает результат в стандартный конвейер аудиоответов.

Свойство	Значение
ID поставщика	`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 Гц (телефония)
Веб-сайт	inworld.ai
Документация	docs.inworld.ai/tts/tts

Установка Plugin

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

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

Начало работы

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

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

Code

INWORLD_API_KEY=<base64-credential-from-dashboard>

Выберите Inworld в messages.tts

json5

{  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`	ID модели 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 с тем же указанием.

Модели

Поддерживаемые ID моделей: 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. Завершающие косые черты удаляются перед отправкой запросов.