TTS Synthesizer | TTS 合成器 🔊

将文字转换为语音，支持微软神经网络 TTS（联网合成）和 OpenAI 兼容 API。

目录

1. 概述
2. 快速开始
3. 脚本说明
4. 声音列表
5. 输出目录
6. 环境变量
7. 故障排查

概述

> ⚠️ 注意：OpenClaw 内置了 tts 工具，但它的输出格式（MP3/WebM）不适合直接发送飞书语音。

> 飞书语音消息必须用 tts_simple.py，它会自动输出 OGG/Opus 格式。

支持的 TTS 引擎

edge-tts 支持的声音（完整列表）

中文（大陆）:

中文（台湾）:

英文:

日文:

韩文:

其他常用:

> 💡 查看完整列表：python3 scripts/tts_edge.py "test" --list-voices

快速开始

1. 安装依赖

cd ~/.openclaw/workspace/skills/tts-synthesizer
pip install -r requirements.txt

2. 运行（生成飞书语音用这个）

# ⭐ tts_simple.py — 输出 OGG/Opus，可直接作为飞书语音发送
python3 scripts/tts_simple.py "你好，这是测试语音"

# 使用指定声音（见下方声音列表）
python3 scripts/tts_simple.py "你好" --voice zh-CN-YunxiNeural

# 使用 API
python3 scripts/tts_simple.py "你好" --engine api \
    --api-url https://api.openai.com/v1 \
    --api-key sk-xxx \
    --voice alloy

3. 调节语速和音调

# 语速 +10%（稍快）
python3 scripts/tts_simple.py "快速播报" --rate "+10%"

# 语速 -10%（稍慢）
python3 scripts/tts_simple.py "慢速播报" --rate "-10%"

# 音调升高
python3 scripts/tts_simple.py "音调较高" --pitch "+5Hz"

脚本说明

scripts/tts_simple.py ⭐ 推荐

通用的文字转语音脚本，自动输出 OGG/Opus 格式，适合飞书语音消息。

python3 scripts/tts_simple.py "要转换的文字" [选项]

参数:

scripts/tts_edge.py

纯粹的 edge-tts 脚本，输出 MP3 格式（不适合直接发送飞书语音）。

# 列出所有声音
python3 scripts/tts_edge.py "test" --list-voices

# 生成语音
python3 scripts/tts_edge.py "你好" -o output.mp3 --voice zh-CN-Xiaoxiao

> 💡 发送飞书语音消息请用 tts_simple.py。

声音列表

edge-tts 支持 100+ 声音，可通过以下命令查看：

python3 scripts/tts_edge.py "test" --list-voices

常用声音速查：

输出格式

重要：飞书语音消息需要 OGG/Opus 格式，必须使用 tts_simple.py。

> tts_simple.py 会自动将 edge-tts 输出的 webm 转换为 OGG/Opus，专门适配飞书语音消息。

输出目录

运行结果保存在工作区的 projects/tts-synthesizer/ 目录下：

~/.openclaw/workspace/projects/tts-synthesizer/
└── output/
    └── tts_20260401_193000.ogg   # OGG/Opus 格式（飞书语音用这个）

环境变量

故障排查

edge-tts 下载失败

# 检查网络
curl -I https://www.bing.com

# edge-tts 需要访问微软服务
# 如有代理干扰，清除环境变量
unset all_proxy ALL_PROXY

API 模式报错

• 确认 API URL 正确（包含 /v1）
• 确认 API Key 有效
• 检查账户余额

声音不自然

• 中文推荐：zh-CN-Xiaoxiao（晓晓）
• 调节语速 --rate "+10%" 或 --rate "-10%"
• 调节音调 --pitch "+3Hz" 或 --pitch "-3Hz"

平台说明

edge-tts vs 其他 TTS 方案

已知限制

• edge-tts 依赖微软服务，需要能访问 edge.microsoft.com
• 部分声音在不同地区可能不可用

目录结构

技能目录（发布用）

tts-synthesizer/
├── SKILL.md                    # 本文档
├── _meta.json                  # 元数据
├── .clawhub/                   # ClawHub 源信息
├── requirements.txt            # Python 依赖
└── scripts/
    ├── tts_simple.py          # 通用 TTS 脚本（⭐ 推荐）
    └── tts_edge.py            # edge-tts 专用脚本

项目目录（运行时数据）

~/.openclaw/workspace/projects/tts-synthesizer/
├── output/                    # TTS 输出文件
└── *.ogg                     # 历史语音文件

模型说明

edge-tts 无本地模型，每次联网合成（微软服务器运行）。

如需本地 GPU TTS（用你自己的显卡），需要额外安装 Coqui XTTS 等。