名称： tts-whatsapp
版本： 1.0.0
描述： 通过自动发送功能，在 WhatsApp 上以 40 多种语言发送高质量的文本转语音语音消息
user-invocable: true
disable-model-invocation: false
标签：
- whatsapp
- tts
- voice
- messaging
- multilingual
- audio
作者： Community
仓库： https://github.com/clawdbot/clawdhub

🎙️ TTS WhatsApp - 支持 40 多种语言的语音消息

通过自动发送功能，在 WhatsApp 上发送高质量的文本转语音语音消息。支持 40 多种语言、个人消息和群组广播。

✨ 功能特性

• 🎙️ 高质量 TTS：基于 Piper 引擎（支持 40 多种语言）
• 🎵 自动格式转换：转换为 OGG/Opus（WhatsApp 格式）
• 📤 自动发送：通过 Clawdbot 自动发送
• 👥 群组支持：可发送给个人或 WhatsApp 群组
• 🌍 多语言支持：法语、英语、西班牙语、德语等 40 多种语言
• 🧹 智能清理：发送成功后自动删除文件
• ⚡ 快速高效：从命令发出到送达约需 2-3 秒

📦 环境准备

1. 安装 Piper TTS：pip3 install --user piper-tts
2. 安装 FFmpeg：
   - macOS：brew install ffmpeg
   - Linux：apt install ffmpeg
3. 下载语音模型：从 Hugging Face 下载
   - 放置路径：~/.clawdbot/skills/piper-tts/models/
   - 示例：fr_FR-siwis-medium.onnx

🚀 快速开始

基础用法

tts-whatsapp "你好，这是一条测试消息" --target "+8612345678901"

发送到 WhatsApp 群组

tts-whatsapp "大家好" --target "120363257357161211@g.us"

切换语言

tts-whatsapp "Hola mundo" --lang es_ES --voice carlfm --target "+34..."

不同质量等级

tts-whatsapp "高质量语音" --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 多种语言！

查看完整语音列表 →

🔧 配置

在 ~/.clawdbot/clawdbot.json 文件中配置：

{
  "skills": {
    "entries": {
      "tts_whatsapp": {
        "enabled": true,
        "env": {
          "WHATSAPP_DEFAULT_TARGET": "+8612345678901",
          "PIPER_DEFAULT_LANG": "en_US",
          "PIPER_DEFAULT_VOICE": "lessac",
          "PIPER_DEFAULT_QUALITY": "medium"
        }
      }
    }
  }
}

🎛️ 全部选项

--target NUMBER       目标 WhatsApp 号码或群组 ID
--message TEXT        要转换为音频的文本消息
--lang LANGUAGE       语言（默认：fr_FR）
--voice VOICE         语音名称（默认：auto）
--quality QUALITY     质量等级：x_low, low, medium, high
--speed SPEED         播放速度（默认：1.0）
--no-send             不自动发送

📊 性能表现

一条 10 秒消息的总处理时间约 2.3 秒：
- TTS 生成：约 1 秒
- 格式转换：约 0.2 秒
- WhatsApp 发送：约 1 秒

📚 完整文档

查看 README.md 获取完整文档、示例和故障排除指南。