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

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

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

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

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

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

INWORLD_API_KEY=<base64-credential-from-dashboard>

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

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

Связанные материалы

Преобразование текста в речь

Обзор TTS, провайдеров и конфигурации messages.tts.

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

Полный справочник по конфигурации, включая настройки messages.tts.

Провайдеры

Все поддерживаемые провайдеры OpenClaw.

Устранение неполадок

Распространённые проблемы и действия по отладке.

Overview

Concepts and configuration

Providers

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

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

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

Примечания

Связанные материалы

Преобразование текста в речь

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

Провайдеры

Устранение неполадок

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

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

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

​Примечания

​Связанные материалы

Преобразование текста в речь

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

Провайдеры

Устранение неполадок

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

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

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

Примечания

Связанные материалы