Feishu Voice Message / 飞书语音消息
Generate Feishu voice messages that play directly in chat (with waveform display) on both mobile and desktop.
生成飞书语音消息，手机和电脑端都能在聊天中直接播放（带波形图显示）。
Key Discovery / 核心发现
Feishu voice messages require OPUS format, not MP3!
飞书语音消息需要 OPUS 格式，不是 MP3！
| Format 格式 | Display 显示 | Desktop 电脑端 |
|---|---|---|
.opus |
Voice message (waveform) 语音消息（波形图） | ✅ Click to play 点击播放 |
.mp3 |
Regular file 普通文件 | Need download 需下载播放 |
Voice Presets / 音色预设
Adult Voices / 成人音色
| Preset 预设 | Voice 音色 | Pitch 音调 | Rate 语速 | Use Case 适用场景 |
|---|---|---|---|---|
manbo |
XiaoyiNeural | +50Hz | default | Lively, energetic 活泼有活力 |
xiaoyi |
XiaoyiNeural | default | +30% | Fast-paced, news 快节奏 |
xiaoxiao |
XiaoxiaoNeural | default | default | Natural, general 自然通用 |
yunyang |
YunyangNeural | default | +10% | Narration, documentary 旁白纪录片 |
Kids Voices / 儿童音色
| Preset 预设 | Voice 音色 | Pitch 音调 | Rate 语速 | Use Case 适用场景 |
|---|---|---|---|---|
xiaotangdou |
XiaoyiNeural | +15% | -5% | Lively, animation, stories 活泼童趣 |
mianhuatang |
XiaoxiaoNeural | +5% | -10% | Gentle, bedtime stories 温柔故事 |
xiaomengmeng |
XiaoxiaoNeural | +10% | -5% | Friendly, educational 亲切教育 |
Usage / 使用方法
Command Line / 命令行
# Basic usage / 基本用法
python scripts/feishu_voice.py "Your text here" --preset manbo
# Kids voice / 儿童音色
python scripts/feishu_voice.py "儿童故事内容" --preset xiaotangdou
Via Agent / 通过代理
# Just ask the agent to generate voice message
# 直接让代理生成语音消息
User: 帮我生成一个语音消息："你好，欢迎使用飞书！" 用小糖豆音色
Agent: [Generates and sends .opus file]
Requirements / 系统要求
-
Edge TTS - Node.js package for text-to-speech
npm install edge-tts -
FFmpeg - For MP3 to OPUS conversion
# Windows: Download from https://ffmpeg.org # Mac: brew install ffmpeg # Linux: sudo apt install ffmpeg
Technical Details / 技术细节
Workflow / 工作流程
- TTS Generation → Generate MP3 using Edge TTS
- Format Conversion → Convert MP3 to OPUS using FFmpeg
- Send to Feishu → Upload as voice message
Text → Edge TTS → MP3 → FFmpeg → OPUS → Feishu Voice Message
FFmpeg Conversion Command / 转换命令
ffmpeg -i input.mp3 -c:a libopus -b:a 64k output.opus
MIME Types / MIME 类型
When sending to Feishu, use correct MIME type:
// Voice message (clickable on desktop)
message({ action: "send", path: "audio.opus", mimeType: "audio/opus" })
// Regular file (download required on desktop)
message({ action: "send", path: "audio.mp3", mimeType: "audio/mpeg" })
Limitations / 限制
- Maximum file size: 30MB / 最大文件大小：30MB
- OPUS is the only format for voice messages / OPUS 是语音消息的唯一格式
- Requires FFmpeg for conversion / 需要安装 FFmpeg 进行转换
References / 参考资料
Created by / 创建者: systiger
Version / 版本: 1.0.0
ClawHub: https://clawhub.ai/systiger/feishu-voice-message