ClawHub

Feishu Voice Message

Automation

Generate Feishu voice messages (with waveform) from text. Auto-converts to OPUS format for in-chat playback on both mobile and desktop. 从文本生成飞书语音消息（带波形图）。自动转换为 OPUS 格式，手机和电脑端都能在聊天中直接播放。 **Triggers / 触发词**: 语音消息、配音、TTS、voice message、text to speech、发送语音

Install

openclaw skills install feishu-voice-message

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 电脑端
.opusVoice message (waveform) 语音消息（波形图）✅ Click to play 点击播放
.mp3Regular file 普通文件Need download 需下载播放

Voice Presets / 音色预设

Adult Voices / 成人音色

Preset 预设Voice 音色Pitch 音调Rate 语速Use Case 适用场景
manboXiaoyiNeural+50HzdefaultLively, energetic 活泼有活力
xiaoyiXiaoyiNeuraldefault+30%Fast-paced, news 快节奏
xiaoxiaoXiaoxiaoNeuraldefaultdefaultNatural, general 自然通用
yunyangYunyangNeuraldefault+10%Narration, documentary 旁白纪录片

Kids Voices / 儿童音色

Preset 预设Voice 音色Pitch 音调Rate 语速Use Case 适用场景
xiaotangdouXiaoyiNeural+15%-5%Lively, animation, stories 活泼童趣
mianhuatangXiaoxiaoNeural+5%-10%Gentle, bedtime stories 温柔故事
xiaomengmengXiaoxiaoNeural+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 / 系统要求

  1. Edge TTS - Node.js package for text-to-speech

    npm install edge-tts

  2. FFmpeg - For MP3 to OPUS conversion

    # Windows: Download from https://ffmpeg.org
# Mac: brew install ffmpeg
# Linux: sudo apt install ffmpeg

Technical Details / 技术细节

Workflow / 工作流程

  1. TTS Generation → Generate MP3 using Edge TTS
  2. Format Conversion → Convert MP3 to OPUS using FFmpeg
  3. 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

More in Automation