> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://inworld.ai) |
| Документация | [docs.inworld.ai/tts/tts](https://docs.inworld.ai/tts/tts) |

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart
```

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

**1. Задайте ключ API**

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
INWORLD_API_KEY=<base64-credential-from-dashboard>
```

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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  messages: {
    tts: {
      auto: "always",
      provider: "inworld",
      providers: {
        inworld: {
          voiceId: "Sarah",
          modelId: "inworld-tts-1.5-max",
        },
      },
    },
  },
}
```

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

Отправьте ответ через любой подключённый канал. 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` (необязательно). |

## Примечания

> [accordion] Аутентификация
>
> Inworld использует аутентификацию HTTP Basic с единой строкой учётных данных, закодированной в Base64. Скопируйте её без изменений из панели управления Inworld. Провайдер отправляет её как `Authorization: Basic <apiKey>` без дополнительного кодирования, поэтому не кодируйте её в Base64 самостоятельно и не передавайте токен в формате Bearer. То же предупреждение приведено в разделе [примечаний об аутентификации TTS](https://docs2.openclaw.ai/ru/tools/tts.md#inworld-primary).

> [accordion] Модели
>
> Поддерживаемые идентификаторы моделей: `inworld-tts-1.5-max` (по умолчанию), `inworld-tts-1.5-mini`, `inworld-tts-1-max`, `inworld-tts-1`.

> [accordion] Выходные аудиоформаты
>
> По умолчанию для ответов используется MP3. Когда целевой канал — `voice-note`, OpenClaw запрашивает у Inworld формат `OGG_OPUS`, чтобы аудио воспроизводилось как встроенное голосовое сообщение. Для синтеза в телефонии используется необработанный формат `PCM` с частотой 22050 Гц, который передаётся в мост телефонии.

> [accordion] Пользовательские конечные точки
>
> Переопределите хост API с помощью `messages.tts.providers.inworld.baseUrl`. Перед отправкой запросов завершающие косые черты удаляются.

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

> [card] [Преобразование текста в речь](https://docs2.openclaw.ai/ru/tools/tts.md)
>
> Обзор TTS, провайдеров и конфигурации `messages.tts`.

> [card] [Конфигурация](https://docs2.openclaw.ai/ru/gateway/configuration.md)
>
> Полный справочник по конфигурации, включая настройки `messages.tts`.

> [card] [Провайдеры](https://docs2.openclaw.ai/ru/providers.md)
>
> Все поддерживаемые провайдеры OpenClaw.

> [card] [Устранение неполадок](https://docs2.openclaw.ai/ru/help/troubleshooting.md)
>
> Распространённые проблемы и действия по отладке.