← 返回 Skills 市场

Feishu Voice Message

Name: Feishu Voice Message
Author: systiger

作者 systiger · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

109

总下载

当前安装

版本数

在 OpenClaw 中安装

/install 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. 从文本生成飞书语音消息（带波形图）。自动转...

使用说明 (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

安全使用建议

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.

功能分析

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.

能力评估

⚠ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install feishu-voice-message
安装完成后，直接呼叫该 Skill 的名称或使用 /feishu-voice-message 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug feishu-voice-message

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题