/install inworld-tts
Inworld TTS
Generate speech audio from text using Inworld.ai's TTS API.
Setup
- Get API key from https://platform.inworld.ai
- Generate key with "Voices: Read" permission
- Copy the "Basic (Base64)" key
- Set environment variable:
export INWORLD_API_KEY="your-base64-key-here"
For persistence, add to ~/.bashrc or ~/.clawdbot/.env.
Installation
# Copy skill to your skills directory
cp -r inworld-tts /path/to/your/skills/
# Make script executable
chmod +x /path/to/your/skills/inworld-tts/scripts/tts.sh
# Optional: symlink for global access
ln -sf /path/to/your/skills/inworld-tts/scripts/tts.sh /usr/local/bin/inworld-tts
Usage
# Basic
./scripts/tts.sh "Hello world" output.mp3
# With options
./scripts/tts.sh "Hello world" output.mp3 --voice Dennis --rate 1.2
# Streaming (for text >4000 chars)
./scripts/tts.sh "Very long text..." output.mp3 --stream
Options
| Option | Default | Description |
|---|---|---|
--voice |
Dennis | Voice ID |
--rate |
1.0 | Speaking rate (0.5-2.0) |
--temp |
1.1 | Temperature (0.1-2.0) |
--model |
inworld-tts-1.5-max | Model ID |
--stream |
false | Use streaming endpoint |
API Reference
| Endpoint | Use |
|---|---|
POST https://api.inworld.ai/tts/v1/voice |
Standard synthesis |
POST https://api.inworld.ai/tts/v1/voice:stream |
Streaming for long text |
Requirements
curl- HTTP requestsjq- JSON processingbase64- Decode audio
Examples
# Quick test
export INWORLD_API_KEY="aXM2..."
./scripts/tts.sh "Testing one two three" test.mp3
mpv test.mp3 # or any audio player
# Different voice and speed
./scripts/tts.sh "Slow and steady" slow.mp3 --rate 0.8
# Fast-paced narration
./scripts/tts.sh "Breaking news!" fast.mp3 --rate 1.5
Troubleshooting
"INWORLD_API_KEY not set" - Export the environment variable before running.
Empty output file - Check API key is valid and has "Voices: Read" permission.
Streaming issues - Ensure jq supports --unbuffered flag.
Links
- Inworld Platform: https://platform.inworld.ai
- API Examples: https://github.com/inworld-ai/inworld-api-examples
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install inworld-tts - 安装完成后,直接呼叫该 Skill 的名称或使用
/inworld-tts触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Inworld TTS 是什么?
Text-to-speech via Inworld.ai API. Use when generating voice audio from text, creating spoken responses, or converting text to MP3/audio files. Supports multiple voices, speaking rates, and streaming for long text. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2206 次。
如何安装 Inworld TTS?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install inworld-tts」即可一键安装,无需额外配置。
Inworld TTS 是免费的吗?
是的,Inworld TTS 完全免费(开源免费),可自由下载、安装和使用。
Inworld TTS 支持哪些平台?
Inworld TTS 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Inworld TTS?
由 Gugic(@gugic)开发并维护,当前版本 v1.0.0。