Skill

tts-whatsapp

From sundial-org-awesome-openclaw-skills-4

Sends high-quality TTS voice messages to WhatsApp numbers or groups in 40+ languages using Piper TTS, FFmpeg, and Clawdbot CLI. Useful for automated multilingual audio delivery.

Python

Hugging Face

cli-tools

automation

Install

npx claudepluginhub joshuarweaver/cascade-ai-ml-agents-misc-2 --plugin sundial-org-awesome-openclaw-skills-4

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Send high-quality text-to-speech voice messages on WhatsApp with automatic delivery. Supports 40+ languages, personal messages, and group broadcasts.

Supporting Assets

CHANGELOG.mdINSTALL.mdLANGUAGES.mdREADME.md

SKILL.md

Similar Skills

cache-components

Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.

cache-components

139.2k

mcp-builder

9 files

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

anthropics-skills-13

124.2k

canvas-design

20 files

Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.

anthropics-skills-13

124.2k

Stats

Stars586

Forks75

Last CommitFeb 1, 2026

Actions

View Source View Plugin View on GitHub View README

🎙️ 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

Piper TTS: pip3 install --user piper-tts
FFmpeg: brew install ffmpeg (macOS) or apt install ffmpeg (Linux)
Voice models: Download from Hugging Face
- Place in ~/.clawdbot/skills/piper-tts/models/
- Example: fr_FR-siwis-medium.onnx

🚀 Quick Start

Basic usage

tts-whatsapp "Hello, this is a test" --target "+15555550123"

Send to WhatsApp group

tts-whatsapp "Hello everyone" --target "120363257357161211@g.us"

Change language

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

Different quality levels

tts-whatsapp "High quality" --quality high --target "+1..."

🌍 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:

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

🎛️ All Options

--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

📊 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.