Providers

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

bash

openclaw plugins install @openclaw/inworld-speechopenclaw 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.

bash

INWORLD_API_KEY=<base64-credential-from-dashboard>

Wybierz Inworld w messages.tts

json5

{  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ń.