https://github.com/longlannet/edge-tts
OpenClaw skill for Microsoft Edge TTS with Telegram OGG/Opus voice-note output
https://github.com/longlannet/edge-tts
agentskill edge-tts openclaw telegram text-to-speech
Last synced: 4 days ago
JSON representation
OpenClaw skill for Microsoft Edge TTS with Telegram OGG/Opus voice-note output
- Host: GitHub
- URL: https://github.com/longlannet/edge-tts
- Owner: longlannet
- License: mit
- Created: 2026-04-25T06:07:00.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-06-06T22:41:35.000Z (23 days ago)
- Last Synced: 2026-06-07T00:13:45.152Z (23 days ago)
- Topics: agentskill, edge-tts, openclaw, telegram, text-to-speech
- Language: Python
- Homepage: https://github.com/longlannet/edge-tts
- Size: 7.81 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# edge-tts
面向 OpenClaw 的文字转语音 skill，使用 Microsoft Edge 在线语音服务生成音频。
基于 Python 包 [`edge-tts`](https://github.com/rany2/edge-tts)。
## 它能做什么
- 把文字生成语音文件
- 默认使用中文女声 `zh-CN-XiaoxiaoNeural`
- 支持指定 Edge Neural voice
- 输出 `MEDIA:/path/to/file`，方便 OpenClaw 自动发送音频
- Telegram 语音泡泡默认使用 `.ogg` / Opus 格式
## 安装
```bash
bash scripts/install.sh
```
## 校验
```bash
bash scripts/check.sh
```
## 常用命令
```bash
./venv/bin/python scripts/speak.py "你好，我是小珍。"
./venv/bin/python scripts/speak.py "Hello from OpenClaw." --voice en-US-AriaNeural
./venv/bin/python scripts/speak.py "语速快一点。" --rate +10%
./venv/bin/python scripts/speak.py "Telegram 语音测试。" --voice-note
./venv/bin/edge-tts --list-voices
```
## Telegram 语音泡泡
如果是在 Telegram 里发送“语音消息 / 语音泡泡 / voice note”，默认使用：
```bash
./venv/bin/python scripts/speak.py "要说的话" --voice-note
```
`--voice-note` 会生成 `.ogg` 文件，并用 Opus 编码，这是 Telegram 原生语音泡泡最稳的格式。普通音频文件才使用默认 `.mp3`。
## 输出规则
`scripts/speak.py` 成功后会打印：
```text
MEDIA:/absolute/path/to/audio.mp3
```
在 OpenClaw 对话里，生成成功后直接回复 `NO_REPLY`，让系统自动发送音频；不要再额外调用消息工具发送同一个文件。
## 说明
- 需要联网访问 Microsoft Edge TTS 服务。
- 生成 `.ogg` / Opus 语音泡泡需要本机安装 `ffmpeg`。
- `venv/` 是本地虚拟环境，`media/` 是生成音频目录，二者不会提交到仓库。
- 如果环境异常，重新运行 `scripts/install.sh`。