语音回复

使用本地 Piper TTS 通过 sherpa-onnx 生成语音音频回复。完全离线，无需云端 API。

功能

• 100% 本地化- 设置完成后无需互联网连接
• 无需 API 密钥- 免费使用，无需账户
• 多语言支持- 包含德语和英语语音
• 支持 Telegram- 输出显示为气泡的语音消息
• 自动检测语言- 根据文本自动选择语音

先决条件

1. sherpa-onnx运行时已安装
2. Piper 语音模型已下载
3. ffmpeg用于音频转换

安装

快速安装

cd scripts
sudo ./install.sh

手动安装

1. 安装 sherpa-onnx

sudo mkdir -p /opt/sherpa-onnx
cd /opt/sherpa-onnx
curl -L -o sherpa.tar.bz2 "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-linux-x64-shared.tar.bz2"
sudo tar -xjf sherpa.tar.bz2 --strip-components=1
rm sherpa.tar.bz2

2. 下载语音模型

sudo mkdir -p /opt/piper-voices
cd /opt/piper-voices

# German - thorsten (medium quality, natural male voice)
curl -L -o thorsten.tar.bz2 "https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/vits-piper-de_DE-thorsten-medium.tar.bz2"
sudo tar -xjf thorsten.tar.bz2 && rm thorsten.tar.bz2

# English - ryan (high quality, clear US male voice)
curl -L -o ryan.tar.bz2 "https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/vits-piper-en_US-ryan-high.tar.bz2"
sudo tar -xjf ryan.tar.bz2 && rm ryan.tar.bz2

3. 安装 ffmpeg

sudo apt install -y ffmpeg

4. 设置环境变量

添加到你的 OpenClaw 服务或 shell 中：

export SHERPA_ONNX_DIR="/opt/sherpa-onnx"
export PIPER_VOICES_DIR="/opt/piper-voices"

用法

{baseDir}/bin/voice-reply "Text to speak" [language]

参数

示例

# German (explicit)
{baseDir}/bin/voice-reply "Hallo, ich bin dein Assistent!" de

# English (explicit)
{baseDir}/bin/voice-reply "Hello, I am your assistant!" en

# Auto-detect (detects German from umlauts and common words)
{baseDir}/bin/voice-reply "Guten Tag, wie geht es dir?"

# Auto-detect (defaults to English)
{baseDir}/bin/voice-reply "The weather is nice today."

输出格式

脚本输出两行供 OpenClaw 在 Telegram 中处理：

[[audio_as_voice]]
MEDIA:/tmp/voice-reply-output.ogg

• [[audio_as_voice]]- 指示 Telegram 以语音气泡显示的标签
• 媒体：路径- 生成的OGG Opus音频文件路径

可用语音

添加更多语音

浏览可用的Piper语音，请访问：

• https://rhasspy.github.io/piper-samples/
• https://github.com/k2-fsa/sherpa-onnx/releases/tag/tts-models

下载并解压到$PIPER_VOICES_DIR，然后修改脚本以包含新语音。

故障排除

"未找到TTS二进制文件"

确保SHERPA_ONNX_DIR已设置且包含bin/sherpa-onnx-offline-tts。

"音频生成失败"

检查语音模型文件是否存在：*.onnx、tokens.txt、espeak-ng-data/

音频以文件形式播放而非语音气泡

确保输出在MEDIA:行之前单独一行包含[[audio_as_voice]]标记。

致谢

• sherpa-onnx- 离线语音处理
• Piper- 快速本地TTS语音
• Thorsten Voice- 德语语音数据集