beware-piper-tts
使用 Piper 在本地将文本转换为语音，用于语音消息推送。当用户请求语音回复、音频消息、TTS、文本转语音、语音笔记或希望听到朗读内容时启用。在本地完成文本到语音的转换（无需云API，无费用，无延迟），并通过支持音频的渠道如...
技能说明
使用 Piper 在本地将文本转换为语音，用于语音消息推送。当用户请求语音回复、音频消息、TTS、文本转语音、语音笔记或希望听到朗读内容时启用。在本地完成文本到语音的转换（无需云API，无费用，无延迟），并通过支持音频的渠道如 Telegram、Discord 等发送语音消息。
Uses Piper for local text-to-speech to deliver voice messages on Telegram or Discord with no cloud costs or latency
查看英文原始说明
Local text-to-speech using Piper for voice message delivery. Use when the user asks for voice responses, audio messages, TTS, text-to-speech, voice notes, or wants to hear something spoken aloud. Converts text to speech locally (no cloud APIs, no cost, no latency) and delivers as voice messages on Telegram, Discord, or any channel supporting audio.
安装步骤
直接复制以下提示词，发送给你的 AI 助手即可完成安装。
- 点击上方「下载 SKILL」按钮，获取技能压缩包。
- 将压缩包解压到你的 Agent 技能目录。
- 重启客户端后即可在技能列表中选择该技能。
技能文件内容
---
name: piper-tts
description: Local text-to-speech using Piper for voice message delivery. Use when the user asks for voice responses, audio messages, TTS, text-to-speech, voice notes, or wants to hear something spoken aloud. Converts text to speech locally (no cloud APIs, no cost, no latency) and delivers as voice messages on Telegram, Discord, or any channel supporting audio.
---
# Piper TTS — Local Voice Messages
Generate voice messages using [Piper](https://github.com/rhasspy/piper), a fast local TTS engine. Zero cloud calls, zero cost, zero API keys.
## Setup
If Piper is not installed, run the setup script:
```bash
scripts/setup-piper.sh
```
This installs `piper-tts` via pip and downloads a default voice (`en_US-kusal-medium`).
## Generating Voice Messages
Use `scripts/piper-speak.sh` to generate and deliver voice:
```bash
scripts/piper-speak.sh "<text>" [voice]
```
- `text`: The text to speak (required)
- `voice`: Piper voice name (default: `en_US-kusal-medium`)
The script outputs an MP3 path. Include it in your reply as:
```
[[audio_as_voice]]
MEDIA:<path-to-mp3>
```
This delivers the audio as a native voice message on supported channels (Telegram, Discord, etc.).
## Example Workflow
1. User asks: "Tell me a joke as audio"
2. Run: `scripts/piper-speak.sh "Why do programmers prefer dark mode? Because light attracts bugs!"`
3. Get MP3 path from output
4. Reply with `[[audio_as_voice]]` + `MEDIA:<path>`
## Available Voices
After setup, download additional voices:
```bash
scripts/setup-piper.sh --voice en_US-ryan-high
scripts/setup-piper.sh --voice en_GB-northern_english_male-medium
```
Popular voices:
- `en_US-kusal-medium` — Clear male voice (default, recommended)
- `en_US-ryan-high` — High quality US male
- `en_US-hfc_male-medium` — US male
- `en_GB-northern_english_male-medium` — British male
- Browse all: https://huggingface.co/rhasspy/piper-voices
## Important Notes
- **Speed**: Local generation is ~0.5-1s. Much faster than cloud TTS.
- **No API keys**: Works completely offline after setup.
- **Platform**: macOS (Apple Silicon + Intel), Linux. Requires Python 3.9+.
- **Do NOT** set `messages.tts.auto: "always"` in OpenClaw config — it makes every response slow. Keep TTS on-demand.
文件内容直接读取自技能仓库，仅供安装前审阅；以实际下载的压缩包为准。