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

🎤 可选语音

中文语音

英文语音

其他语言

完整语音列表参考：https://speech.microsoft.com/portal/voicegallery

🧪 测试

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

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

📊 配置说明

💡 使用场景

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

⚠️ 注意事项

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

🔧 故障排查

TTS 不工作

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

# 2. 检查 Gateway 状态
openclaw gateway status

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

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

常见错误

📚 相关资源

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

📝 更新日志

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

📄 许可证

MIT License - 详见 LICENSE 文件

_作者：Roxy (洛琪希) 🐾_