Przejdź do głównej treści
Inworld jest dostawcą strumieniowego tekstu na mowę (TTS). W OpenClaw syntetyzuje wychodzące odpowiedzi audio (domyślnie MP3, OGG_OPUS dla notatek głosowych) oraz 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 audio base64 w jeden bufor i przekazuje wynik do standardowego potoku odpowiedzi audio.
WłaściwośćWartość
Identyfikator dostawcyinworld
Pluginoficjalny pakiet zewnętrzny
KontraktspeechProviders (tylko TTS)
Zmienna env uwierzytelnianiaINWORLD_API_KEY (HTTP Basic, poświadczenie Base64 z panelu)
Bazowy URLhttps://api.inworld.ai
Domyślny głosSarah
Domyślny modelinworld-tts-1.5-max
WyjścieMP3 (domyślnie), OGG_OPUS (notatki głosowe), PCM 22050 Hz (telefonia)
Stronainworld.ai
Dokumentacjadocs.inworld.ai/tts/tts

​
Zainstaluj plugin

Zainstaluj oficjalny plugin, a następnie uruchom ponownie Gateway: 
openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart

​
Pierwsze kroki

1

Set your API key

Skopiuj poświadczenie z panelu Inworld (Workspace > API Keys) i ustaw je jako zmienną env. Wartość jest wysyłana dosłownie jako poświadczenie HTTP Basic, więc nie koduj jej ponownie w Base64 ani nie konwertuj jej na token typu bearer.
INWORLD_API_KEY=<base64-credential-from-dashboard>
2

Select Inworld in messages.tts

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

Send a message

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 notatki głosowej).

​
Opcje konfiguracji

OpcjaŚcieżkaOpis
apiKeymessages.tts.providers.inworld.apiKeyPoświadczenie Base64 z panelu. Awaryjnie używa INWORLD_API_KEY.
baseUrlmessages.tts.providers.inworld.baseUrlNadpisuje bazowy URL API Inworld (domyślnie https://api.inworld.ai).
speakerVoiceIdmessages.tts.providers.inworld.speakerVoiceIdIdentyfikator głosu (domyślnie Sarah).
modelIdmessages.tts.providers.inworld.modelIdIdentyfikator modelu TTS (domyślnie inworld-tts-1.5-max).
temperaturemessages.tts.providers.inworld.temperatureTemperatura próbkowania 0..2 (opcjonalnie).

​
Uwagi

Inworld używa uwierzytelniania HTTP Basic z jednym ciągiem poświadczenia zakodowanym w Base64. Skopiuj go dosłownie z panelu Inworld. Dostawca wysyła go jako Authorization: Basic <apiKey> bez żadnego dalszego kodowania, więc nie koduj go samodzielnie w Base64 i nie przekazuj tokena w stylu bearer. Zobacz uwagi dotyczące uwierzytelniania TTS, aby zapoznać się z tym samym wyróżnieniem.
Obsługiwane identyfikatory modeli: inworld-tts-1.5-max (domyślny), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.
Odpowiedzi domyślnie używają MP3. Gdy celem kanału jest voice-note, OpenClaw prosi Inworld o OGG_OPUS, aby dźwięk był odtwarzany jako natywny dymek głosowy. Synteza telefoniczna używa surowego PCM przy 22050 Hz, aby zasilać most telefoniczny.
Nadpisz host API za pomocą messages.tts.providers.inworld.baseUrl. Końcowe ukośniki są usuwane przed wysłaniem żądań.

​
Powiązane

Text-to-speech

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

Configuration

Pełna dokumentacja konfiguracji, w tym ustawienia messages.tts.

Providers

Wszyscy obsługiwani dostawcy OpenClaw.

Troubleshooting

Typowe problemy i kroki debugowania.