前言¶
在 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
