edge-tts 實戰：免費語音合成，零 API Key

讓你的 AI Agent 開口說話

---

為什麼選 edge-tts？

市面上的 TTS 方案主要有三種：

• OpenAI TTS：質量好，但 $15/百萬字元，生產環境用起來心疼
• Google TTS：價格類似，還需要信用卡綁定
• edge-tts：微軟 Neural TTS 引擎，完全免費，零 API Key

edge-tts 是透過呼叫 Edge 瀏覽器內建的 TTS 服務實現的。微軟沒有正式公開這個介面，但社群已經維護了多年，穩定性可以接受。

---

基本資訊

項目	內容
引擎	Microsoft Neural TTS
語言支援	74 種語言
聲音數量	300+
費用	免費
API Key	不需要
輸出格式	MP3 / WAV / OGG

---

安裝

clawhub install edge-tts

openclaw tts "你好，世界"

---

中文聲音推薦

聲音 ID	風格	適合場景
zh-CN-XiaoxiaoNeural	溫柔女聲	客服、通知、朗讀
zh-CN-YunxiNeural	活力男聲	教學、播客
zh-CN-YunjianNeural	沉穩男聲	正式場合、報告
zh-TW-HsiaoChenNeural	台灣腔女聲	台灣用戶

---

語速和音調控制

openclaw tts --rate=+20% "這是一段測試"
openclaw tts --pitch=-10Hz "這是一段測試"
openclaw tts --voice=zh-CN-YunxiNeural "你好"

---

常見踩坑

坑 1：網路限制：edge-tts 需要訪問微軟伺服器，在某些網路環境下可能不穩定。建議設定代理或使用備用聲音 ID。

坑 2：長文字截斷：單次請求超過 3000 字元可能被截斷。把長文字分段，每段不超過 2000 字元。

坑 3：聲音 ID 變化：微軟偶爾會更新聲音庫，舊的聲音 ID 可能失效。遇到報錯先用 openclaw tts --list-voices 查可用清單。

---

實際應用場景

1. 每日簡報播報：把 daily-trending 技能獲取的熱點轉成語音，早上起來直接聽
2. 郵件朗讀：搭配 email-daily-summary，不用盯著螢幕
3. 提醒通知：Agent 完成任務後，語音提醒你查看結果

---

SFD Lab | 零費用 TTS 首選