Перейти к основному содержанию
Inworld — это поставщик потокового преобразования текста в речь (TTS). В OpenClaw он синтезирует аудио исходящих ответов (MP3 по умолчанию, OGG_OPUS для голосовых заметок) и PCM-аудио для телефонных каналов, таких как голосовой вызов. OpenClaw отправляет запросы в потоковую конечную точку TTS Inworld, объединяет возвращенные фрагменты аудио в base64 в единый буфер и передает результат в стандартный конвейер аудиоответов.
СвойствоЗначение
ID поставщикаinworld
Pluginофициальный внешний пакет
КонтрактspeechProviders (только TTS)
Переменная окружения для аутентификацииINWORLD_API_KEY (HTTP Basic, учетные данные панели управления в Base64)
Базовый URLhttps://api.inworld.ai
Голос по умолчаниюSarah
Модель по умолчаниюinworld-tts-1.5-max
ВыводMP3 (по умолчанию), OGG_OPUS (голосовые заметки), PCM 22050 Гц (телефония)
Веб-сайтinworld.ai
Документацияdocs.inworld.ai/tts/tts

Установка Plugin

Установите официальный Plugin, затем перезапустите Gateway:
openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart

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

1

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

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

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

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

Отправьте сообщение

Отправьте ответ через любой подключенный канал. OpenClaw синтезирует аудио с помощью Inworld и доставляет его как MP3 (или OGG_OPUS, когда канал ожидает голосовую заметку).

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

ПараметрПутьОписание
apiKeymessages.tts.providers.inworld.apiKeyУчетные данные панели управления в Base64. Использует INWORLD_API_KEY как запасной вариант.
baseUrlmessages.tts.providers.inworld.baseUrlПереопределяет базовый URL API Inworld (по умолчанию https://api.inworld.ai).
speakerVoiceIdmessages.tts.providers.inworld.speakerVoiceIdИдентификатор голоса (по умолчанию Sarah).
modelIdmessages.tts.providers.inworld.modelIdID модели TTS (по умолчанию inworld-tts-1.5-max).
temperaturemessages.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. Завершающие косые черты удаляются перед отправкой запросов.

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

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

Обзор TTS, поставщики и конфигурация messages.tts.

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

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

Поставщики

Все поддерживаемые поставщики OpenClaw.

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

Распространенные проблемы и шаги отладки.