Inworld

Inworld to dostawca strumieniowej syntezy mowy (TTS). W OpenClaw syntetyzuje dźwięk odpowiedzi wychodzących (domyślnie MP3, OGG_OPUS dla wiadomości głosowych) oraz surowy dźwięk PCM dla kanałów telefonicznych, takich jak Voice Call. OpenClaw wysyła żądania do strumieniowego punktu końcowego TTS Inworld, łączy zwrócone fragmenty dźwięku zakodowane w base64 w jeden bufor i przekazuje wynik do standardowego potoku dźwięku odpowiedzi.

Właściwość	Wartość
Identyfikator dostawcy	`inworld`
Plugin	oficjalny pakiet zewnętrzny (`@openclaw/inworld-speech`)
Kontrakt	`speechProviders` (tylko TTS)
Zmienna środowiskowa uwierzytelniania	`INWORLD_API_KEY` (HTTP Basic, dane uwierzytelniające z panelu w formacie Base64)
Bazowy adres URL	`https://api.inworld.ai`
Domyślny głos	`Sarah`
Domyślny model	`inworld-tts-1.5-max`
Format wyjściowy	MP3 (domyślnie), OGG_OPUS (wiadomości głosowe), PCM 22050 Hz (telefonia)
Witryna	inworld.ai
Dokumentacja	docs.inworld.ai/tts/tts

Instalowanie pluginu

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

Pierwsze kroki

Ustaw klucz API

Skopiuj dane uwierzytelniające z panelu Inworld (Workspace > API Keys) i ustaw je jako zmienną środowiskową. Wartość jest wysyłana bez zmian jako dane uwierzytelniające HTTP Basic, dlatego nie koduj jej ponownie w formacie Base64 ani nie przekształcaj w token typu bearer.

INWORLD_API_KEY=<base64-credential-from-dashboard>

Wybierz Inworld w messages.tts

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

Wyślij wiadomość

Wyślij odpowiedź przez dowolny połączony kanał. OpenClaw syntetyzuje dźwięk za pomocą Inworld i dostarcza go jako MP3 (lub OGG_OPUS, gdy kanał oczekuje wiadomości głosowej).

Opcje konfiguracji

Opcja	Ścieżka	Opis
`apiKey`	`messages.tts.providers.inworld.apiKey`	Dane uwierzytelniające z panelu w formacie Base64. W razie braku używa `INWORLD_API_KEY`.
`baseUrl`	`messages.tts.providers.inworld.baseUrl`	Zastępuje bazowy adres URL API Inworld (domyślnie `https://api.inworld.ai`).
`voiceId`	`messages.tts.providers.inworld.voiceId`	Identyfikator głosu (domyślnie `Sarah`). Starszy alias: `speakerVoiceId`.
`modelId`	`messages.tts.providers.inworld.modelId`	Identyfikator modelu TTS (domyślnie `inworld-tts-1.5-max`).
`temperature`	`messages.tts.providers.inworld.temperature`	Temperatura próbkowania, od `0` (wyłącznie) do `2` (opcjonalna).

Uwagi

Uwierzytelnianie

Inworld używa uwierzytelniania HTTP Basic z jednym ciągiem danych uwierzytelniających zakodowanym w Base64. Skopiuj go bez zmian z panelu Inworld. Dostawca wysyła go jako Authorization: Basic <apiKey> bez dodatkowego kodowania, dlatego nie koduj go samodzielnie w formacie Base64 ani nie przekazuj tokenu typu bearer. To samo zastrzeżenie znajdziesz w uwagach dotyczących uwierzytelniania TTS.

Modele

Obsługiwane identyfikatory modeli: inworld-tts-1.5-max (domyślny), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.

Formaty wyjściowe dźwięku

Odpowiedzi domyślnie używają formatu MP3. Gdy docelowym typem kanału jest voice-note, OpenClaw żąda od Inworld formatu OGG_OPUS, aby dźwięk był odtwarzany jako natywna wiadomość głosowa. Synteza dla telefonii używa surowego formatu PCM z częstotliwością 22050 Hz, aby zasilać most telefoniczny.

Niestandardowe punkty końcowe

Zastąp host API za pomocą messages.tts.providers.inworld.baseUrl. Końcowe ukośniki są usuwane przed wysłaniem żądań.

Powiązane

Synteza mowy

Omówienie TTS, dostawcy i konfiguracja messages.tts.

Konfiguracja

Pełna dokumentacja konfiguracji, w tym ustawień messages.tts.

Dostawcy

Wszyscy obsługiwani dostawcy OpenClaw.

Rozwiązywanie problemów

Typowe problemy i kroki debugowania.

Overview

Concepts and configuration

Providers

Instalowanie pluginu

Pierwsze kroki

Opcje konfiguracji

Uwagi

Powiązane

Synteza mowy

Konfiguracja

Dostawcy

Rozwiązywanie problemów

​Instalowanie pluginu

​Pierwsze kroki

​Opcje konfiguracji

​Uwagi

​Powiązane

Synteza mowy

Konfiguracja

Dostawcy

Rozwiązywanie problemów

Instalowanie pluginu

Pierwsze kroki

Opcje konfiguracji

Uwagi

Powiązane