← Back to Skills Marketplace
109
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install feishu-voice-message
Description
Generate Feishu voice messages (with waveform) from text. Auto-converts to OPUS format for in-chat playback on both mobile and desktop. 从文本生成飞书语音消息（带波形图）。自动转...
README (SKILL.md)
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
Usage Guidance
This skill is useful as a local generator (text → MP3 → OPUS) but it has two important issues you should consider before installing or running it:
1) Functional mismatch: The published description and SKILL.md imply that the skill will upload/send voice messages to Feishu, but the included Python script only generates & converts audio files and prints their paths — it does not call Feishu APIs or perform any upload. If you expect automatic sending to Feishu, that functionality is missing and would require additional code and Feishu credentials.
2) Hidden/external dependency: The script calls node on a hard-coded path (~/.openclaw/workspace/skills/edge-tts/scripts/tts-converter.js). That file is not included in this package and is not a standard location for the edge-tts npm package. Before running, verify that the referenced node script exists and review its contents — it will execute with your user privileges and could run arbitrary code. If it does not exist, the script will fail.
Other considerations:
- The skill requires installing edge-tts (npm) and ffmpeg; install packages only from sources you trust.
- The Python script passes the TTS text as CLI arguments to node (subprocess list used, not a shell string), which reduces but does not eliminate risk from untrusted inputs.
- Files are written to a temp path (TEMP or /tmp/openclaw), so check filesystem permissions and cleanup needs.
Recommendations before use: inspect the node tts-converter.js that this script calls (or change the script to call a known installation of edge-tts), confirm whether you need Feishu upload code (and if so add proper credential handling), and only run after verifying the external node script and npm package sources. If you want a safe, local-only usage, treat this as an audio generator/converter and do not expect automatic Feishu delivery.
Capability Analysis
Type: OpenClaw Skill
Name: feishu-voice-message
Version: 1.0.0
The skill is a legitimate utility for generating Feishu-compatible voice messages (OPUS format) from text using Edge TTS and FFmpeg. The Python script `scripts/feishu_voice.py` safely uses `subprocess.run` to call external tools, and the instructions in `SKILL.md` are consistent with the stated functionality without any signs of prompt injection or malicious intent.
Capability Assessment
Purpose & Capability
The name/description claim generation of Feishu voice messages and show examples of sending to Feishu, but the provided Python script only generates MP3 and converts to OPUS and stops — it does not call Feishu APIs or upload files. That is an overclaim or missing functionality. Also the script invokes a node script at ~/.openclaw/workspace/skills/edge-tts/scripts/tts-converter.js, which is an undeclared, hard-coded dependency not described in SKILL.md or manifest.
Instruction Scope
SKILL.md instructs installing edge-tts and ffmpeg and shows Feishu API examples and 'agent: generates and sends .opus file', but the runtime Python instructions only create files locally. The agent-facing phrasing may lead users to expect automatic uploading; the actual code does not. The script also executes an external node script by path, which grants that external file the ability to run arbitrary code when this skill is used.
Install Mechanism
There is no install spec (instruction-only), which minimizes installation footprint. However SKILL.md requires npm edge-tts and system ffmpeg. The Python script does not call npm directly but calls node on a specific path under ~/.openclaw — a hidden reliance on another skill or local file that may not exist or that could be tampered with.
Credentials
The skill requests no credentials or secrets and only uses the TEMP environment variable to choose a temp path. No disproportionate access to unrelated credentials or config paths is requested.
Persistence & Privilege
always is false and the skill does not request persistent or privileged system presence. It does not modify other skills or system settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install feishu-voice-message - After installation, invoke the skill by name or use
/feishu-voice-message - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of feishu-voice-message.
- Generate Feishu-compatible voice messages (with waveform) from text and auto-convert to OPUS format for direct playback in chat.
- Supports multiple voice presets for both adult and child voices.
- Command-line usage and agent integration provided.
- Requires Edge TTS and FFmpeg for audio generation and conversion.
- Enforces OPUS as the output format to ensure optimal in-chat playback on both mobile and desktop.
Metadata
Frequently Asked Questions
What is Feishu Voice Message?
Generate Feishu voice messages (with waveform) from text. Auto-converts to OPUS format for in-chat playback on both mobile and desktop. 从文本生成飞书语音消息（带波形图）。自动转... It is an AI Agent Skill for Claude Code / OpenClaw, with 109 downloads so far.
How do I install Feishu Voice Message?
Run "/install feishu-voice-message" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Feishu Voice Message free?
Yes, Feishu Voice Message is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Feishu Voice Message support?
Feishu Voice Message is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Feishu Voice Message?
It is built and maintained by systiger (@systiger); the current version is v1.0.0.
More Skills