Edge TTS Skill - 免费语音合成
🎤 使用微软 Edge TTS 实现免费的文本转语音功能，无需 API Key！
📦 安装
# 本地安装
cd ~/.openclaw/workspace/skills
git clone <repo-url> edge-tts
# 或通过 clawhub (如果已发布)
openclaw skills install edge-tts
⚙️ 配置
方式一：通过 CLI 配置
# 启用 Edge TTS
openclaw config set messages.tts.provider edge
openclaw config set messages.tts.auto always
openclaw config set messages.tts.providers.edge.enabled true
openclaw config set messages.tts.providers.edge.voice zh-CN-XiaoxiaoNeural
# 重启 Gateway
openclaw gateway restart
方式二：手动编辑配置
编辑 ~/.openclaw/openclaw.json，添加/修改以下配置：
{
"messages": {
"tts": {
"auto": "always",
"provider": "edge",
"providers": {
"edge": {
"enabled": true,
"voice": "zh-CN-XiaoxiaoNeural"
}
}
}
}
}
然后重启 Gateway：
openclaw gateway restart
🎤 可选语音
中文语音
| 语音 ID | 描述 | 性别 |
|---|---|---|
zh-CN-XiaoxiaoNeural | 温柔女声 | 女 |
zh-CN-YunxiNeural | 阳光男声 | 男 |
zh-CN-YunjianNeural | 成熟男声 | 男 |
zh-CN-XiaoyiNeural | 活泼女声 | 女 |
zh-CN-XiaochenNeural | 知性女声 | 女 |
zh-CN-liaoning-XiaobeiNeural | 东北话 | 女 |
zh-CN-shaanxi-XiaoniNeural | 陕西话 | 女 |
英文语音
| 语音 ID | 描述 |
|---|---|
en-US-JennyNeural | 美国女声 |
en-US-GuyNeural | 美国男声 |
en-GB-SoniaNeural | 英国女声 |
en-GB-RyanNeural | 英国男声 |
其他语言
完整语音列表参考：https://speech.microsoft.com/portal/voicegallery
🧪 测试
# 使用 tts 工具测试
openclaw tts "你好，我是 Edge TTS"
# 或在聊天中直接说话，会自动触发 TTS (如果 auto: always)
📊 配置说明
| 配置项 | 说明 | 默认值 |
|---|---|---|
messages.tts.auto | TTS 触发模式 | always / never / mention |
messages.tts.provider | 默认 TTS 供应商 | edge |
messages.tts.providers.edge.enabled | 是否启用 Edge TTS | true |
messages.tts.providers.edge.voice | 语音 ID | zh-CN-XiaoxiaoNeural |
💡 使用场景
- ✅ 个人助手 - 让 AI 助手用语音回复
- ✅ 无障碍辅助 - 为视障用户提供语音输出
- ✅ 多语言支持 - 支持 100+ 种语言
- ✅ 成本敏感 - 完全免费，无 API 调用限制
⚠️ 注意事项
- 网络连接 - Edge TTS 需要访问微软服务
- 速率限制 - 微软可能有隐式速率限制，大量使用需注意
- 音频格式 - 输出为音频文件，通过消息平台发送
- 自动播放 - 部分平台/客户端可能需要用户手动播放音频
🔧 故障排查
TTS 不工作
# 1. 检查配置
openclaw config get messages.tts
# 2. 检查 Gateway 状态
openclaw gateway status
# 3. 查看日志
openclaw gateway logs --follow
# 4. 运行诊断
openclaw doctor --fix
常见错误
| 错误 | 原因 | 解决方案 |
|---|---|---|
microsoft: no provider registered | Edge TTS 未正确配置 | 确保 messages.tts.providers.edge.enabled 为 true |
| 音频无法播放 | 平台不支持 | 检查消息平台是否支持音频附件 |
| 语音不对 | 语音 ID 错误 | 确认语音 ID 拼写正确 |
📚 相关资源
📝 更新日志
- 2026-04-07 - 初始版本，支持 Edge TTS 配置和中文语音
📄 许可证
MIT License - 详见 LICENSE 文件
作者：Roxy (洛琪希) 🐾