Mosaic concepts pages now own the adapted content; source/license
metadata under docs/reference/concepts. Adds ACT-1 agent-context
planning capture, pinned concept test package + preparation utility,
foundation observation notes (durability, evidence, federation,
onboarding, workflow), and the #1495 consolidation assessment.
TOOLS.md updated for the host-dev launcher.
Inworld streaming text-to-speech for OpenClaw replies
You want Inworld speech synthesis for outbound replies
You need PCM telephony or OGG_OPUS voice-note output from Inworld
Inworld
Inworld is a streaming text-to-speech (TTS) provider. In OpenClaw it synthesizes outbound reply audio (MP3 by default, OGG_OPUS for voice notes) and raw PCM audio for telephony channels such as Voice Call.
OpenClaw posts to Inworld's streaming TTS endpoint, concatenates the returned base64 audio chunks into a single buffer, and hands the result to the standard reply-audio pipeline.
Property
Value
Provider id
inworld
Plugin
official external package (@openclaw/inworld-speech)
Copy the credential from your Inworld dashboard (Workspace > API Keys) and set it as an env var. The value is sent verbatim as the HTTP Basic credential, so do not Base64-encode it again or convert it to a bearer token.
```json5
{
tts: {
auto: "always",
provider: "inworld",
providers: {
inworld: {
voiceId: "Sarah",
modelId: "inworld-tts-1.5-max",
},
},
},
}
```
Send a reply through any connected channel. OpenClaw synthesizes the audio with Inworld and delivers it as MP3 (or OGG_OPUS when the channel expects a voice note).
Configuration options
Option
Path
Description
apiKey
tts.providers.inworld.apiKey
Base64 dashboard credential. Falls back to INWORLD_API_KEY.
baseUrl
tts.providers.inworld.baseUrl
Override Inworld API base URL (default https://api.inworld.ai).
Sampling temperature, 0 (exclusive) to 2 (optional).
Notes
Inworld uses HTTP Basic auth with a single Base64-encoded credential string. Copy it verbatim from the Inworld dashboard. The provider sends it as `Authorization: Basic ` without any further encoding, so do not Base64-encode it yourself and do not pass a bearer-style token. See [TTS auth notes](/tools/tts#inworld-primary) for the same callout.
Supported model ids: `inworld-tts-1.5-max` (default), `inworld-tts-1.5-mini`, `inworld-tts-1-max`, `inworld-tts-1`.
Replies use MP3 by default. When the channel target is `voice-note`, OpenClaw asks Inworld for `OGG_OPUS` so the audio plays as a native voice bubble. Telephony synthesis uses raw `PCM` at 22050 Hz to feed the telephony bridge.
Override the API host with `tts.providers.inworld.baseUrl`. Trailing slashes are stripped before requests are sent.
Related
TTS overview, providers, and `tts` config.
Full config reference including `tts` settings.
All supported OpenClaw providers.
Common issues and debugging steps.
jason.woltje
193479b52d