Providers

Inworld

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

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

Свойство	Значение
Идентификатор провайдера	`inworld`
Плагин	официальный внешний пакет (`@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

Установка плагина

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