前言¶
在 OpenClaw 里跑 QQ 机器人时，纯文字回复往往不够直观：用户希望听到语音，而自建 TTS 服务又要占机器、配密钥、维护进程。若你已经在用 SkillHub 管理 Agent 技能，又希望 QQ 通道能稳定发中文语音，就需要一条不依赖付费 API、又能和主进程隔离的合成链路。下面介绍社区 Skill edge-tts-voice 的定位、能力与安装方式。
这是什么¶
edge-tts-voice（坐标 @user_77841619/edge-tts-voice，当前版本 2.1.0，来源 community，分类 design-media）由 SkillHub 用户 user_77841619（页面显示作者「疯不觉」）发布。官方简介概括为：为 OpenClaw QQBot 提供语音合成能力——装上后，机器人可通过 QQ 发送语音消息（官方文案中的「小龙虾」指 OpenClaw 生态下的 QQ 机器人场景）。
Skill 标签标明 requires_api_key=false，即不依赖单独申请的 TTS API Key；合成侧使用 Microsoft Edge TTS 公开接口，面向中文场景做了语音与长文本方面的优化。
核心功能¶
以下能力均来自 SkillHub 页面与 API 元数据中的说明，未在资料中出现的参数或接口名不作延伸。
- 零 API Key 成本：基于 Edge TTS 公开 API，官方表述为完全免费、无使用成本。
- 中文语音：支持 5 种中文音色——晓晓、云希、云健、小艺、云扬。
- 稳定性：进程级隔离、OS 级超时、自动重试；子进程崩溃不应拖垮主进程。
- 长文本：支持单次 5000+ 字符合成，并强调 UTF-8 编码优化。
- 延迟参考：短文本约 2–3 秒；长文本约 30–60 秒（为官方给出的经验区间，实际取决于文本长度与运行环境）。
安装与启用¶
SkillHub 官方给出的安装指引是：让 Agent 阅读 SkillHub 安装文档，并安装坐标 @user_77841619/edge-tts-voice。若本机已有 skillhub CLI，可按文档第三节将技能装进当前 Agent 实际使用的 skills 目录（装错目录会导致 Agent 无法加载，部分环境还需重启后生效）。
先确认 CLI 是否可用：
command -v skillhub && skillhub --version
未安装时，文档提供的完整安装方式为：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，将 --dir 指向你正在使用的 Agent skills 路径，例如：
skillhub install @user_77841619/edge-tts-voice --dir <你的 skills 目录>
文档中列出的常见路径包括：
- Claude Code：
~/.claude/skills/ - Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
OpenClaw 及其变体（NanoBot、PicoClaw、memUBot、MaxClaw、CoPaw、AutoClaw、KimiClaw、QClaw、EasyClaw、workbuddy 等）通常也有各自的 skills 目录，需按你当前运行的客户端对照文档自行确定。公开资料未单独列出 Cursor / Codex / Claude Code 针对本 Skill 的差异配置，启用后以各 Agent 加载 Skill 的通用机制为准。
典型用法¶
公开页面未附带可复制的脚本级调用示例或 SKILL.md 内联命令。从官方描述的链路理解用法即可复现目标：
- 在 OpenClaw QQBot 所在环境中安装并启用
@user_77841619/edge-tts-voice。 - 在需要语音回复的对话流程中，将待回复文本交给 Skill 提供的合成能力（由 Agent 按 Skill 说明调用），得到音频后再通过 QQ 通道发送。
官方列出的直接场景包括：QQBot 自动语音回复、文章朗读、助手语音化，以及「任何需要中文 TTS 的 OpenClaw 通道」——后一类需你根据具体通道自行适配。
适用场景与注意¶
适合谁：已在 OpenClaw（尤其 QQBot）上跑自动化回复，希望用免费中文 TTS、且不想维护独立合成服务的开发者。
需要留意的点：
- 依赖 Edge TTS 公开 API 的可用性与策略；Skill 文档未承诺 SLA，生产环境应自行观察失败率与超时行为。
- 长文本合成耗时可能达到数十秒，不适合对实时性极敏感的路径。
- 非 QQ 的 OpenClaw 通道需自行对接音频格式与发送方式；官方已说明需「根据实际情况进行适配」。
- SkillHub 元数据为社区来源（
community），升级前可在页面核对版本（当前 v2.1.0）。
结尾¶
edge-tts-voice 把 Edge TTS 的中文合成能力封装成 SkillHub 可安装的技能，主打免 API Key、中文音色与进程隔离，面向 QQBot 语音回复等场景。安装与坐标以 SkillHub 为准：
- 技能页：https://www.skillhub.cn/skills/user_77841619/edge-tts-voice
- API 元数据：https://api.skillhub.cn/user_77841619/edge-tts-voice
