/install feishu-tts-pro
feishu-tts-pro
将中文文字转换为语音,直接发送为飞书语音气泡消息。
使用方法
# 发送语音消息(默认发送给 FEISHU_DEFAULT_USER)
tts-send "你好,这是番茄的语音回复"
# 发送给指定用户
tts-send "你好" ou_xxxxx
环境变量(必填)
| 变量 | 说明 |
|---|---|
FEISHU_APP_ID |
飞书应用 App ID |
FEISHU_APP_SECRET |
飞书应用 App Secret |
FEISHU_DEFAULT_USER |
默认接收者的 open_id(可选,未提供时需要命令行参数) |
环境变量(可选)
| 变量 | 默认值 | 说明 |
|---|---|---|
EDGE_TTS_VOICE |
zh-CN-YunxiNeural |
Edge-TTS 音色 |
PYTHON_BIN |
系统 Python | Python 路径(用于 edge-tts) |
可选音色
| 音色 | 说明 |
|---|---|
zh-CN-YunxiNeural |
云希(男声,活泼阳光,默认) |
zh-CN-XiaoxiaoNeural |
晓晓(女声,温和) |
zh-CN-YunyangNeural |
云扬(男声,专业) |
zh-CN-XiaoyiNeural |
晓逸(女声,甜美) |
zh-CN-tianxiangNeural |
天祥(男声,大气) |
技术流程
- Edge-TTS 生成 MP3(使用指定音色)
- FFmpeg 转码为 ogg/opus(16kHz, mono, 飞书兼容)
- 上传到飞书(file_type=opus,duration 嵌入)
- 发送 audio 消息气泡
依赖
- Node.js 18+
- Python 3.8+ + edge-tts(
pip install edge-tts) - FFmpeg(系统安装)
安装 edge-tts
pip install edge-tts
或使用 uv:
uv pip install edge-tts --python /path/to/your/python
配置示例
在 AGENTS.md 或 openclaw.json 中配置:
{
"skills": {
"entries": {
"feishu-tts-pro": {
"env": {
"FEISHU_APP_ID": "cli_xxxxxxxxxxxx",
"FEISHU_APP_SECRET": "xxxxxxxxxxxxxxxx",
"FEISHU_DEFAULT_USER": "ou_xxxxxxxxxxxx",
"EDGE_TTS_VOICE": "zh-CN-YunxiNeural"
}
}
}
}
}
故障排除
TTS 生成失败
- 确认 edge-tts 已安装:
python -c "import edge_tts" - 确认 Python 路径正确
语音气泡无时长显示
- 上传时需要传入 duration 参数(毫秒)
- 脚本已自动处理
发送失败 (code=99991663)
- 检查 App ID/Secret 是否正确
- 确认飞书应用已开通「发消息」权限
Powered by 番茄 (OpenClaw Agent)
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install feishu-tts-pro - After installation, invoke the skill by name or use
/feishu-tts-pro - Provide required inputs per the skill's parameter spec and get structured output
What is 飞书TTS Pro?
将文字转换为语音并以飞书语音气泡消息发送。使用 Edge-TTS(微软,免费,无限次)生成中文语音,FFmpeg 转码为 ogg/opus,上传到飞书作为 audio 类型消息。支持自定义音色、接收者和 Python 环境。当用户要求用语音回复、发语音消息、TTS 朗读内容时触发。 It is an AI Agent Skill for Claude Code / OpenClaw, with 40 downloads so far.
How do I install 飞书TTS Pro?
Run "/install feishu-tts-pro" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is 飞书TTS Pro free?
Yes, 飞书TTS Pro is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does 飞书TTS Pro support?
飞书TTS Pro is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created 飞书TTS Pro?
It is built and maintained by minybear (@minybear); the current version is v1.0.0.