Edge TTS Skill - 免费语音合成#

🎤 使用微软 Edge TTS 实现免费的文本转语音功能，无需 API Key！

---

📦 安装#

bash

# 本地安装
cd ~/.openclaw/workspace/skills
git clone <repo-url> edge-tts

# 或通过 clawhub (如果已发布)
openclaw skills install edge-tts

---

⚙️ 配置#

方式一：通过 CLI 配置#

bash

# 启用 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，添加/修改以下配置：

json

{
  "messages": {
    "tts": {
      "auto": "always",
      "provider": "edge",
      "providers": {
        "edge": {
          "enabled": true,
          "voice": "zh-CN-XiaoxiaoNeural"
        }
      }
    }
  }
}

然后重启 Gateway：

bash

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

---

🧪 测试#

bash

# 使用 tts 工具测试
openclaw tts "你好，我是 Edge TTS"

# 或在聊天中直接说话，会自动触发 TTS (如果 auto: always)

---

📊 配置说明#

配置项说明默认值messages.tts.autoTTS 触发模式always / never / mention``messages.tts.provider默认 TTS 供应商edge``messages.tts.providers.edge.enabled是否启用 Edge TTStrue``messages.tts.providers.edge.voice语音 IDzh-CN-XiaoxiaoNeural

---

💡 使用场景#

• ✅ 个人助手 - 让 AI 助手用语音回复
• ✅ 无障碍辅助 - 为视障用户提供语音输出
• ✅ 多语言支持 - 支持 100+ 种语言
• ✅ 成本敏感 - 完全免费，无 API 调用限制

---

⚠️ 注意事项#

1. 网络连接 - Edge TTS 需要访问微软服务
2. 速率限制 - 微软可能有隐式速率限制，大量使用需注意
3. 音频格式 - 输出为音频文件，通过消息平台发送
4. 自动播放 - 部分平台/客户端可能需要用户手动播放音频

---

🔧 故障排查#

TTS 不工作#

bash

# 1. 检查配置
openclaw config get messages.tts

# 2. 检查 Gateway 状态
openclaw gateway status

# 3. 查看日志
openclaw gateway logs --follow

# 4. 运行诊断
openclaw doctor --fix

常见错误#

错误原因解决方案microsoft: no provider registeredEdge TTS 未正确配置确保 messages.tts.providers.edge.enabled 为 true音频无法播放平台不支持检查消息平台是否支持音频附件语音不对语音 ID 错误确认语音 ID 拼写正确

---

📚 相关资源#

• OpenClaw TTS 文档
• 微软 Edge TTS 语音列表
• Edge TTS Python 库

---

📝 更新日志#

• 2026-04-07 - 初始版本，支持 Edge TTS 配置和中文语音

---

📄 许可证#

MIT License - 详见 LICENSE 文件

作者：Roxy (洛琪希) 🐾