Agent Skills
返回列表
Edge TTS 中文语音合成服务

Edge TTS 中文语音合成服务

设计多媒体 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_77841619/edge-tts-voice。

技能介绍

它解决什么问题

OpenClaw QQBot 需要稳定地把中文文本变成语音回复时，直接调用本地合成库或第三方接口经常会遇到三类问题：进程耦合导致崩溃、长文本触发参数或编码异常，以及服务超时后缺少恢复路径。该技能把 Microsoft Edge TTS 做成一个可本地调用的语音服务，目标不是替换 Bot 框架，而是给 QQBot 增加一条可用的中文语音输出链路。

技能如何工作

技能采用 CLI 方案 + 本地服务 的结构：edge-tts Python 包负责实际合成，Node.js 服务暴露语音生成接口，Bot 侧通过 127.0.0.1:5050 调用结果。

  • 语音选择：内置多种中文 Neural 语音，默认 zh-CN-XiaoxiaoNeural，可切换 zh-CN-YunxiNeural、zh-CN-YunjianNeural、zh-CN-XiaoyiNeural、zh-CN-YunyangNeural。
  • 长文本处理：对超长文本使用 UTF-8 临时文件传递，避免 Windows 命令行参数长度和中文编码问题。
  • 稳定性机制：子进程隔离、60 秒 OS 级超时、最多 3 次重试、指数退避，目标是降低临时网络波动导致的失败率。
  • 配置边界：安装脚本会处理依赖检查、workspace 部署、openclaw.json 配置和 Windows 计划任务，但运行时需要 Python、Node.js 16+ 和网络访问。

适用边界与注意点

它适合本地 Windows 环境、需要中文语音回复、并且可以开放 5050 端口的 Bot 场景。若部署在无外网环境，或者需要完全离线 TTS，该方案不适用。使用时应确认 edge-tts 可用、端口未被占用、防火墙允许本地回环访问。技能不承诺替代商业 TTS 的音色质量或合规边界，只提供一个面向中文内容的可用语音合成路径。

使用场景

  • 为 OpenClaw QQBot 接入免费中文语音，使文字消息能返回晓晓等音色。
  • 在 Windows 本机部署 5050 端口的语音服务，供 Bot 调用 edge-tts CLI。
  • 让长通知或播报超过命令行参数限制时，通过 UTF-8 临时文件完成合成。
  • 排查语音生成失败时，依据超时、重试和日志定位网络或端口问题。

适合人员

  • 维护 OpenClaw QQBot 的机器人工程师，需要给中文消息增加语音回复。
  • 部署 Windows 本地服务的后端工程师，需要管理 5050 端口和计划任务。
  • 处理播报内容的社区运营，需要把长通知合成为自然中文语音。
  • 排查语音故障的技术支持，需要根据日志定位超时、重试或编码问题。