介绍
# 🎙️ TTS WhatsApp - Voice Messages in 40+ Languages
通过 WhatsApp 发送高质量文本转语音消息，并自动投递。支持 40 多种语言、个人消息和群组广播。
## ✨ 功能
- 🎙️ **高质量 TTS** 由 Piper 驱动（支持 40 多种语言） - 🎵 **自动转换** 为 OGG/Opus 格式（WhatsApp 格式） - 📤 **自动发送** 通过 Clawdbot - 👥 **群组支持** - 发送给个人或 WhatsApp 群组 - 🌍 **多语言** - 法语、英语、西班牙语、德语以及 40 多种其他语言 - 🧹 **智能清理** - 发送成功后自动删除文件 - ⚡ **快速** - 从执行命令到投递仅需约 2-3 秒
## 📦 前置要求
1. **Piper TTS**: `pip3 install --user piper-tts` 2. **FFmpeg**: `brew install ffmpeg` (macOS) 或 `apt install ffmpeg` (Linux) 3. **语音模型**: 从 [Hugging Face](https://huggingface.co/rhasspy/piper-voices) 下载 - 放置于 `~/.clawdbot/skills/piper-tts/models/` - 示例: `fr_FR-siwis-medium.onnx`
## 🚀 快速开始
### 基本用法 ```bash tts-whatsapp "Hello, this is a test" --target "+15555550123" ```
### 发送到 WhatsApp 群组 ```bash tts-whatsapp "Hello everyone" --target "[email protected]" ```
### 更改语言 ```bash tts-whatsapp "Hola mundo" --lang es_ES --voice carlfm --target "+34..." ```
### 不同的质量级别 ```bash tts-whatsapp "High quality" --quality high --target "+1..." ```
## 🌍 支持的语言
- 🇫🇷 法语 (`fr_FR`): siwis, upmc, tom - 🇬🇧 英语英式 (`en_GB`): alan, alba - 🇺🇸 英语美式 (`en_US`): lessac, amy, joe - 🇪🇸 西班牙语 (`es_ES`, `es_MX`): carlfm, davefx - 🇩🇪 德语 (`de_DE`): thorsten, eva_k - 🇮🇹 意大利语 (`it_IT`): riccardo - 🇵🇹 葡萄牙语 (`pt_BR`, `pt_PT`): faber - 🇳🇱 荷兰语 (`nl_NL`): mls, rdh - 🇷🇺 俄语 (`ru_RU`): dmitri, irina - 以及 30 多种其他语言！
[完整语音列表 →](https://rhasspy.github.io/piper-samples/)
## 🔧 配置
在 `~/.clawdbot/clawdbot.json` 中进行配置：
```json { "skills": { "entries": { "tts_whatsapp": { "enabled": true, "env": { "WHATSAPP_DEFAULT_TARGET": "+15555550123", "PIPER_DEFAULT_LANG": "en_US", "PIPER_DEFAULT_VOICE": "lessac", "PIPER_DEFAULT_QUALITY": "medium" } } } } } ```
## 🎛️ 所有选项
``` --target NUMBER WhatsApp number or group ID --message TEXT Text message with audio --lang LANGUAGE Language (default: fr_FR) --voice VOICE Voice name (default: auto) --quality QUALITY x_low, low, medium, high --speed SPEED Playback speed (default: 1.0) --no-send Don't send automatically ```
## 📊 性能
10 秒的消息总计耗时约 2.3 秒： - TTS 生成：约 1 秒 - 格式转换：约 0.2 秒 - WhatsApp 投递：约 1 秒
## 📚 完整文档
查看 [README.md](README.md) 以获取完整文档、示例和故障排除指南。