Zum Hauptinhalt springen
Inworld ist ein Streaming-Text-to-Speech-(TTS)-Provider. In OpenClaw synthetisiert er ausgehendes Antwort-Audio (standardmäßig MP3, OGG_OPUS für Sprachnotizen) und PCM-Audio für Telefoniekanäle wie Voice Call. OpenClaw sendet an Inworlds Streaming-TTS-Endpunkt, fügt die zurückgegebenen base64-Audio-Chunks zu einem einzelnen Buffer zusammen und übergibt das Ergebnis an die standardmäßige Antwort-Audio-Pipeline.
EigenschaftWert
Provider-IDinworld
Pluginoffizielles externes Paket
VertragspeechProviders (nur TTS)
Auth-Env-VarINWORLD_API_KEY (HTTP Basic, Base64-Dashboard-Anmeldedaten)
Basis-URLhttps://api.inworld.ai
StandardstimmeSarah
Standardmodellinworld-tts-1.5-max
AusgabeMP3 (Standard), OGG_OPUS (Sprachnotizen), PCM 22050 Hz (Telefonie)
Websiteinworld.ai
Dokudocs.inworld.ai/tts/tts

​
Plugin installieren

Installieren Sie das offizielle Plugin und starten Sie anschließend den Gateway neu: 
openclaw plugins install @openclaw/inworld-speech
openclaw gateway restart

​
Erste Schritte

1

API-Schlüssel festlegen

Kopieren Sie die Anmeldedaten aus Ihrem Inworld-Dashboard (Workspace > API Keys) und legen Sie sie als Env-Var fest. Der Wert wird unverändert als HTTP-Basic- Anmeldedaten gesendet. Codieren Sie ihn daher nicht erneut mit Base64 und wandeln Sie ihn nicht in ein Bearer- Token um.
INWORLD_API_KEY=<base64-credential-from-dashboard>
2

Inworld in messages.tts auswählen

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

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 Sprachnotiz erwartet).

​
Konfigurationsoptionen

OptionPfadBeschreibung
apiKeymessages.tts.providers.inworld.apiKeyBase64-Dashboard-Anmeldedaten. Fällt auf INWORLD_API_KEY zurück.
baseUrlmessages.tts.providers.inworld.baseUrlÜberschreibt die Basis-URL der Inworld-API (Standard https://api.inworld.ai).
speakerVoiceIdmessages.tts.providers.inworld.speakerVoiceIdStimmkennung (Standard Sarah).
modelIdmessages.tts.providers.inworld.modelIdTTS-Modell-ID (Standard inworld-tts-1.5-max).
temperaturemessages.tts.providers.inworld.temperatureSampling-Temperatur 0..2 (optional).

​
Hinweise

Inworld verwendet HTTP-Basic-Auth mit einer einzelnen Base64-codierten Anmeldedatenzeichenfolge. Kopieren Sie sie unverändert aus dem Inworld-Dashboard. Der Provider sendet sie als Authorization: Basic <apiKey> ohne weitere Codierung. Codieren Sie sie daher nicht selbst mit Base64 und übergeben Sie kein Bearer-artiges Token. Siehe TTS-Auth-Hinweise für denselben Hinweis.
Unterstützte Modell-IDs: inworld-tts-1.5-max (Standard), inworld-tts-1.5-mini, inworld-tts-1-max, inworld-tts-1.
Antworten verwenden standardmäßig MP3. Wenn das Kanalziel voice-note ist, fordert OpenClaw bei Inworld OGG_OPUS an, damit das Audio als native Sprachblase wiedergegeben wird. Telefoniesynthese verwendet rohes PCM mit 22050 Hz, um die Telefonie-Bridge zu speisen.
Überschreiben Sie den API-Host mit messages.tts.providers.inworld.baseUrl. Abschließende Schrägstriche werden entfernt, bevor Anfragen gesendet werden.

​
Verwandt

Text-to-Speech

TTS-Übersicht, Provider und messages.tts-Konfiguration.

Konfiguration

Vollständige Konfigurationsreferenz einschließlich messages.tts-Einstellungen.

Provider

Alle unterstützten OpenClaw-Provider.

Fehlerbehebung

Häufige Probleme und Debugging-Schritte.