← Back to Skills Marketplace
dadaniya99

Feishu Edge TTS Voice

by dadaniya99 · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
1539
Downloads
2
Stars
10
Active Installs
1
Versions
Install in OpenClaw
/install feishu-edge-tts-voice
Description
飞书语音消息发送技能。使用 Edge TTS(微软,免费无限次)生成语音并以飞书语音气泡形式发送。当用户要求用语音回复、发语音消息、TTS 朗读内容时触发。默认音色:云希(zh-CN-YunxiNeural,活泼阳光男声)。
README (SKILL.md)

飞书语音消息发送

快速使用

python3 ~/.openclaw/workspace/skills/feishu-voice/scripts/send_voice.py \
  "要说的内容" \
  \x3Copen_id>

工作流程

  1. edge-tts 生成 mp3
  2. ffmpeg 转换为 opus(飞书语音格式)
  3. 飞书 API 上传文件获取 file_key(file_type=opus)
  4. 发送 msg_type=audio 消息

关键:必须用 msg_type: audio + file_key,不能用普通文件上传,否则显示为文件而非语音气泡。

音色选择

# 查看所有中文音色
edge-tts --list-voices | grep zh-CN

# 常用中文男声
zh-CN-YunxiNeural    # 云希 - 活泼阳光(默认,小龙虾专用)
zh-CN-YunjianNeural  # 云间 - 激情澎湃
zh-CN-YunxiaNeural   # 云夏 - 可爱萌
zh-CN-YunyangNeural  # 云扬 - 专业严肃

# 常用中文女声
zh-CN-XiaoxiaoNeural # 小小 - 温柔
zh-CN-XiaoyiNeural   # 小艺 - 活泼

# 指定音色发送
python3 ~/.openclaw/workspace/skills/feishu-voice/scripts/send_voice.py \
  "内容" \x3Copen_id> --voice zh-CN-YunyangNeural

依赖安装

pip install edge-tts  # 一次性安装,永久免费
# ffmpeg 通常已预装,如没有:yum install ffmpeg / apt install ffmpeg

飞书配置

需要 openclaw.json 中的 feishu appId / appSecret,脚本自动读取。

Usage Guidance
Before installing or running this skill: (1) Inspect ~/.openclaw/openclaw.json and confirm it contains only the Feishu appId/appSecret you intend to use — don't point the script at a file containing broad secrets. (2) Prefer creating a Feishu app with minimal permissions for this purpose. (3) Because the registry metadata does not declare the required config/credentials, treat that omission as a red flag: either ask the publisher to update the metadata or avoid installing until it's fixed. (4) Review the included scripts/send_voice.py yourself (it is small and readable); if you run it, do so in an environment where executing curl/ffmpeg/edge-tts is acceptable (or sandboxed). (5) If you want stronger guarantees, request the skill be updated to accept credentials via a clearly-declared config path or dedicated environment variables (and update registry metadata accordingly). Additional info that would raise confidence to 'high': metadata that explicitly declares the required config path and primary credential, or an updated script that only reads a minimal, well-documented credentials file.
Capability Analysis
Type: OpenClaw Skill Name: feishu-edge-tts-voice Version: 1.0.0 The skill bundle is designed to send voice messages via Feishu using Edge TTS and FFmpeg. All network calls are directed to the legitimate Feishu API (`open.feishu.cn`). While the script `scripts/send_voice.py` uses `subprocess.run` for `ffmpeg` and `curl`, the inputs to these commands (temporary file paths, API tokens from JSON responses, hardcoded parameters) appear to be controlled and do not present clear shell injection vulnerabilities. The `SKILL.md` instructions are straightforward and do not contain any prompt injection attempts against the agent. The script accesses Feishu credentials (`appId`, `appSecret`) from `~/.openclaw/openclaw.json`, but this is necessary for its stated purpose and there is no evidence of exfiltration or misuse of these credentials.
Capability Assessment
Purpose & Capability
The skill's functionality (Edge TTS -> convert -> upload to Feishu) matches the code and instructions. However, the package metadata declares no required credentials or config paths while the runtime script expects a ~/.openclaw/openclaw.json containing feishu appId/appSecret. That omission is an inconsistency: the skill does need Feishu credentials (in a config file) even though the registry metadata lists none.
Instruction Scope
SKILL.md and the script keep to a narrow scope: generate audio with edge-tts, convert with ffmpeg, obtain a Feishu tenant token, upload the opus file, and send an audio message. Network calls go only to open.feishu.cn and no other external endpoints. One scope note: the script loads the entire openclaw.json and then accesses cfg['channels']['feishu'] — it only uses feishu fields, but because it reads the whole config file it could access other secrets if modified.
Install Mechanism
There is no automated install spec (instruction-only plus a script). The README tells users to pip install edge-tts and to ensure ffmpeg is present. This is low-risk compared with arbitrary download-and-extract installs. Users should still install edge-tts/ffmpeg from trusted sources.
Credentials
The skill requires Feishu app credentials (appId/appSecret) but does not declare them in requires.env or required config paths in the registry metadata; instead it expects them inside ~/.openclaw/openclaw.json. That mismatch is a proportionality/visibility problem. Also, because the script opens the entire JSON file, if you keep other sensitive credentials there they could be read into memory — the script currently only uses the Feishu fields, but the practice means sensitive data is being accessed without being declared.
Persistence & Privilege
The skill is not always-included and is user-invocable. It does not modify other skills or system configuration. No elevated persistence privileges are requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install feishu-edge-tts-voice
  3. After installation, invoke the skill by name or use /feishu-edge-tts-voice
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
用微软 Edge TTS 发送飞书语音气泡。免费无限次,支持中文男/女声,默认云希音色。
Metadata
Slug feishu-edge-tts-voice
Version 1.0.0
License
All-time Installs 12
Active Installs 10
Total Versions 1
Frequently Asked Questions

What is Feishu Edge TTS Voice?

飞书语音消息发送技能。使用 Edge TTS(微软,免费无限次)生成语音并以飞书语音气泡形式发送。当用户要求用语音回复、发语音消息、TTS 朗读内容时触发。默认音色:云希(zh-CN-YunxiNeural,活泼阳光男声)。 It is an AI Agent Skill for Claude Code / OpenClaw, with 1539 downloads so far.

How do I install Feishu Edge TTS Voice?

Run "/install feishu-edge-tts-voice" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Feishu Edge TTS Voice free?

Yes, Feishu Edge TTS Voice is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Feishu Edge TTS Voice support?

Feishu Edge TTS Voice is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Feishu Edge TTS Voice?

It is built and maintained by dadaniya99 (@dadaniya99); the current version is v1.0.0.

💬 Comments