by 运行时依赖
安装命令
点击复制技能文档
Edge TTS 技能 - 免费语音合成
🎤 使用微软 Edge TTS 实现免费的文本转语音功能，无需 API Key！
📦 安装 # 本地安装 cd ~/.OpenClaw/workspace/技能s git clone edge-tts
# 或通过 ClawHub (如果已发布) OpenClaw 技能s 安装 edge-tts
⚙️ 配置 方式一：通过 命令行工具 配置 # 启用 Edge TTS OpenClaw config 设置 messages.tts.提供者 edge OpenClaw config 设置 messages.tts.auto always OpenClaw config 设置 messages.tts.提供者s.edge.enabled true OpenClaw config 设置 messages.tts.提供者s.edge.voice zh-CN-XiaoxiaoNeural
# 重启 Gateway OpenClaw gateway re启动
方式二：手动编辑配置
编辑 ~/.OpenClaw/OpenClaw.json，添加/修改以下配置：
{ "messages": { "tts": { "auto": "always", "提供者": "edge", "提供者s": { "edge": { "enabled": true, "voice": "zh-CN-XiaoxiaoNeural" } } } } }
然后重启 Gateway：
OpenClaw gateway re启动
🎤 可选语音 中文语音 语音 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.提供者 默认 TTS 供应商 edge messages.tts.提供者s.edge.enabled 是否启用 Edge TTS true messages.tts.提供者s.edge.voice 语音 ID zh-CN-XiaoxiaoNeural 💡 使用场景 ✅ 个人助手 - 让 AI 助手用语音回复 ✅ 无障碍辅助 - 为视障用户提供语音输出 ✅ 多语言支持 - 支持 100+ 种语言 ✅ 成本敏感 - 完全免费，无 API 调用限制 ⚠️ 注意事项 网络连接 - Edge TTS 需要访问微软服务 速率限制 - 微软可能有隐式速率限制，大量使用需注意 音频格式 - 输出为音频文件，通过消息平台发送 自动播放 - 部分平台/客户端可能需要用户手动播放音频 🔧 故障排查 TTS 不工作 # 1. 检查配置 OpenClaw config 获取 messages.tts
# 2. 检查 Gateway 状态 OpenClaw gateway 状态
# 3. 查看日志 OpenClaw gateway 记录s --follow
# 4. 运行诊断 OpenClaw doctor --fix
常见错误 错误 原因 解决方案 microsoft: no 提供者 registered Edge TTS 未正确配置 确保 messages.tts.提供者s.edge.enabled 为 true 音频无法播放 平台不支持 检查消息平台是否支持音频附件 语音不对 语音 ID 错误 确认语音 ID 拼写正确 📚 相关资源 OpenClaw TTS 文档 微软 Edge TTS 语音列表 Edge TTS Python 库 📝 更新日志 2026-04-07 - 初始版本，支持 Edge TTS 配置和中文语音 📄 许可证
MIT License - 详见 LICENSE 文件
作者：Roxy (洛琪希) 🐾