🎙️ TTS WhatsApp - Voice Messages in 40+ Languages
Send high-quality text-to-speech voice messages on WhatsApp with automatic delivery. Supports 40+ languages, personal messages, and group broadcasts.
✨ Features
- - 🎙️ High-quality TTS powered by Piper (40+ languages)
- 🎵 Automatic conversion to OGG/Opus (WhatsApp format)
- 📤 Automatic sending via Clawdbot
- 👥 Group support - Send to individuals or WhatsApp groups
- 🌍 Multi-language - French, English, Spanish, German, and 40+ more
- 🧹 Smart cleanup - Auto-delete files after successful send
- ⚡ Fast - ~2-3s from command to delivery
📦 Prerequisites
- 1. Piper TTS: INLINECODE0
- FFmpeg:
brew install ffmpeg (macOS) or apt install ffmpeg (Linux) - Voice models: Download from Hugging Face
- Place in
~/.clawdbot/skills/piper-tts/models/
- Example: INLINECODE4
🚀 Quick Start
Basic usage
CODEBLOCK0
Send to WhatsApp group
CODEBLOCK1
Change language
CODEBLOCK2
Different quality levels
CODEBLOCK3
🌍 Supported Languages
- - 🇫🇷 French (
fr_FR): siwis, upmc, tom - 🇬🇧 English GB (
en_GB): alan, alba - 🇺🇸 English US (
en_US): lessac, amy, joe - 🇪🇸 Spanish (
es_ES, es_MX): carlfm, davefx - 🇩🇪 German (
de_DE): thorsten, eva_k - 🇮🇹 Italian (
it_IT): riccardo - 🇵🇹 Portuguese (
pt_BR, pt_PT): faber - 🇳🇱 Dutch (
nl_NL): mls, rdh - 🇷🇺 Russian (
ru_RU): dmitri, irina - And 30+ more!
Full voice list →
🔧 Configuration
Configure in ~/.clawdbot/clawdbot.json:
CODEBLOCK4
🎛️ All Options
CODEBLOCK5
📊 Performance
~2.3s total for a 10-second message:
- - TTS generation: ~1s
- Format conversion: ~0.2s
- WhatsApp delivery: ~1s
📚 Full Documentation
See README.md for complete documentation, examples, and troubleshooting.
🎙️ TTS WhatsApp - 支持40+种语言的语音消息
在WhatsApp上发送高质量文本转语音消息，支持自动投递。兼容40+种语言、个人消息和群组广播。
✨ 功能特性
- - 🎙️ 高质量TTS 基于Piper引擎（支持40+种语言）
- 🎵 自动转换 为OGG/Opus格式（WhatsApp专用格式）
- 📤 自动发送 通过Clawdbot实现
- 👥 群组支持 - 可发送给个人或WhatsApp群组
- 🌍 多语言 - 法语、英语、西班牙语、德语等40+种语言
- 🧹 智能清理 - 发送成功后自动删除文件
- ⚡ 快速响应 - 从指令到投递仅需约2-3秒
📦 前置条件
- 1. Piper TTS：pip3 install --user piper-tts
- FFmpeg：brew install ffmpeg（macOS）或 apt install ffmpeg（Linux）
- 语音模型：从 Hugging Face 下载
- 放置于 ~/.clawdbot/skills/piper-tts/models/
- 示例：fr_FR-siwis-medium.onnx
🚀 快速开始
基本用法
bash
tts-whatsapp 你好，这是一条测试消息 --target +15555550123
发送至WhatsApp群组
bash
tts-whatsapp 大家好 --target 120363257357161211@g.us
切换语言
bash
tts-whatsapp Hola mundo --lang es_ES --voice carlfm --target +34...
不同质量等级
bash
tts-whatsapp 高质量语音 --quality high --target +1...
🌍 支持的语言
- - 🇫🇷 法语（frFR）：siwis, upmc, tom
- 🇬🇧 英式英语（enGB）：alan, alba
- 🇺🇸 美式英语（enUS）：lessac, amy, joe
- 🇪🇸 西班牙语（esES, esMX）：carlfm, davefx
- 🇩🇪 德语（deDE）：thorsten, evak
- 🇮🇹 意大利语（itIT）：riccardo
- 🇵🇹 葡萄牙语（ptBR, ptPT）：faber
- 🇳🇱 荷兰语（nlNL）：mls, rdh
- 🇷🇺 俄语（ruRU）：dmitri, irina
- 以及30+种其他语言！
完整语音列表 →
🔧 配置说明
在 ~/.clawdbot/clawdbot.json 中配置：
json
{
skills: {
entries: {
tts_whatsapp: {
enabled: true,
env: {
WHATSAPPDEFAULTTARGET: +15555550123,
PIPERDEFAULTLANG: en_US,
PIPERDEFAULTVOICE: lessac,
PIPERDEFAULTQUALITY: medium
}
}
}
}
}
🎛️ 全部选项
--target NUMBER WhatsApp号码或群组ID
--message TEXT 附带音频的文本消息
--lang LANGUAGE 语言（默认：fr_FR）
--voice VOICE 语音名称（默认：自动）
--quality QUALITY x_low, low, medium, high
--speed SPEED 播放速度（默认：1.0）
--no-send 不自动发送
📊 性能表现
10秒消息约需2.3秒：
- - TTS生成：约1秒
- 格式转换：约0.2秒
- WhatsApp投递：约1秒
📚 完整文档
请参阅 README.md 获取完整文档、示例和故障排除指南。
