Providers

Inworld

Inworld ist ein Provider für Streaming-Text-to-Speech (TTS). In OpenClaw synthetisiert er Audio für ausgehende Antworten (standardmäßig MP3, OGG_OPUS für Sprachnachrichten) sowie unkomprimiertes PCM-Audio für Telefoniekanäle wie Voice Call.

OpenClaw sendet Anfragen an den Streaming-TTS-Endpunkt von Inworld, fügt die zurückgegebenen Base64-Audiosegmente zu einem einzelnen Puffer zusammen und übergibt das Ergebnis an die standardmäßige Pipeline für Antwortaudio.

Eigenschaft	Wert
Provider-ID	`inworld`
Plugin	offizielles externes Paket (`@openclaw/inworld-speech`)
Vertrag	`speechProviders` (nur TTS)
Auth.-Umgebungsvar.	`INWORLD_API_KEY` (HTTP Basic, Base64-Zugangsdaten aus dem Dashboard)
Basis-URL	`https://api.inworld.ai`
Standardstimme	`Sarah`
Standardmodell	`inworld-tts-1.5-max`
Ausgabe	MP3 (Standard), OGG_OPUS (Sprachnachrichten), PCM 22050 Hz (Telefonie)
Website	inworld.ai
Dokumentation	docs.inworld.ai/tts/tts

Plugin installieren

bash

openclaw plugins install @openclaw/inworld-speechopenclaw gateway restart

Erste Schritte

API-Schlüssel festlegen

Kopieren Sie die Zugangsdaten aus Ihrem Inworld-Dashboard (Workspace > API Keys) und legen Sie sie als Umgebungsvariable fest. Der Wert wird unverändert als HTTP-Basic-Zugangsdaten gesendet. Codieren Sie ihn daher nicht erneut mit Base64 und wandeln Sie ihn nicht in ein Bearer-Token um.

bash

INWORLD_API_KEY=<base64-zugangsdaten-aus-dem-dashboard>

Inworld in messages.tts auswählen

json5

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

Nachricht senden

Senden Sie eine Antwort über einen beliebigen verbundenen Kanal. OpenClaw synthetisiert das Audio mit Inworld und liefert es als MP3 aus (oder als OGG_OPUS, wenn der Kanal eine Sprachnachricht erwartet).

Konfigurationsoptionen

Option	Pfad	Beschreibung
`apiKey`	`messages.tts.providers.inworld.apiKey`	Base64-Zugangsdaten aus dem Dashboard. Verwendet ersatzweise `INWORLD_API_KEY`.
`baseUrl`	`messages.tts.providers.inworld.baseUrl`	Überschreibt die Basis-URL der Inworld-API (Standard: `https://api.inworld.ai`).
`voiceId`	`messages.tts.providers.inworld.voiceId`	Stimmkennung (Standard: `Sarah`). Veralteter Alias: `speakerVoiceId`.
`modelId`	`messages.tts.providers.inworld.modelId`	TTS-Modell-ID (Standard: `inworld-tts-1.5-max`).
`temperature`	`messages.tts.providers.inworld.temperature`	Sampling-Temperatur, größer als `0` bis einschließlich `2` (optional).

Hinweise

Authentifizierung

Inworld verwendet HTTP-Basic-Authentifizierung mit einer einzelnen Base64-codierten Zeichenfolge für die Zugangsdaten. Kopieren Sie diese unverändert aus dem Inworld-Dashboard. Der Provider sendet sie ohne weitere Codierung als Authorization: Basic <apiKey>. Codieren Sie sie daher nicht selbst mit Base64 und übergeben Sie kein Token im Bearer-Stil. Den gleichen Hinweis finden Sie unter Hinweise zur TTS-Authentifizierung.

Modelle

Unterstützte Modell-IDs: inworld-tts-1.5-max (Standard), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.

Audioausgaben

Antworten verwenden standardmäßig MP3. Wenn das Kanalziel voice-note ist, fordert OpenClaw bei Inworld OGG_OPUS an, damit das Audio als native Sprachnachricht wiedergegeben wird. Die Telefoniesynthese verwendet unkomprimiertes PCM mit 22050 Hz zur Einspeisung in die Telefonie-Bridge.

Benutzerdefinierte Endpunkte

Überschreiben Sie den API-Host mit messages.tts.providers.inworld.baseUrl. Abschließende Schrägstriche werden entfernt, bevor Anfragen gesendet werden.