← 返回 Skills 市场
minybear

飞书TTS Pro

作者 minybear · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
40
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install feishu-tts-pro
功能描述
将文字转换为语音并以飞书语音气泡消息发送。使用 Edge-TTS(微软,免费,无限次)生成中文语音,FFmpeg 转码为 ogg/opus,上传到飞书作为 audio 类型消息。支持自定义音色、接收者和 Python 环境。当用户要求用语音回复、发语音消息、TTS 朗读内容时触发。
使用说明 (SKILL.md)

feishu-tts-pro

将中文文字转换为语音,直接发送为飞书语音气泡消息。

使用方法

# 发送语音消息(默认发送给 FEISHU_DEFAULT_USER)
tts-send "你好,这是番茄的语音回复"

# 发送给指定用户
tts-send "你好" ou_xxxxx

环境变量(必填)

变量 说明
FEISHU_APP_ID 飞书应用 App ID
FEISHU_APP_SECRET 飞书应用 App Secret
FEISHU_DEFAULT_USER 默认接收者的 open_id(可选,未提供时需要命令行参数)

环境变量(可选)

变量 默认值 说明
EDGE_TTS_VOICE zh-CN-YunxiNeural Edge-TTS 音色
PYTHON_BIN 系统 Python Python 路径(用于 edge-tts)

可选音色

音色 说明
zh-CN-YunxiNeural 云希(男声,活泼阳光,默认)
zh-CN-XiaoxiaoNeural 晓晓(女声,温和)
zh-CN-YunyangNeural 云扬(男声,专业)
zh-CN-XiaoyiNeural 晓逸(女声,甜美)
zh-CN-tianxiangNeural 天祥(男声,大气)

技术流程

  1. Edge-TTS 生成 MP3(使用指定音色)
  2. FFmpeg 转码为 ogg/opus(16kHz, mono, 飞书兼容)
  3. 上传到飞书(file_type=opus,duration 嵌入)
  4. 发送 audio 消息气泡

依赖

  • Node.js 18+
  • Python 3.8+ + edge-tts(pip install edge-tts
  • FFmpeg(系统安装)

安装 edge-tts

pip install edge-tts

或使用 uv:

uv pip install edge-tts --python /path/to/your/python

配置示例

AGENTS.mdopenclaw.json 中配置:

{
  "skills": {
    "entries": {
      "feishu-tts-pro": {
        "env": {
          "FEISHU_APP_ID": "cli_xxxxxxxxxxxx",
          "FEISHU_APP_SECRET": "xxxxxxxxxxxxxxxx",
          "FEISHU_DEFAULT_USER": "ou_xxxxxxxxxxxx",
          "EDGE_TTS_VOICE": "zh-CN-YunxiNeural"
        }
      }
    }
  }
}

故障排除

TTS 生成失败

  • 确认 edge-tts 已安装:python -c "import edge_tts"
  • 确认 Python 路径正确

语音气泡无时长显示

  • 上传时需要传入 duration 参数(毫秒)
  • 脚本已自动处理

发送失败 (code=99991663)

  • 检查 App ID/Secret 是否正确
  • 确认飞书应用已开通「发消息」权限

Powered by 番茄 (OpenClaw Agent)

安全使用建议
This skill's code appears to do what it claims, but there are small incoherences you should address before installing: 1) The registry marks EDGE_TTS_VOICE, PYTHON_BIN, and FEISHU_DEFAULT_USER as required env vars even though the README and script treat them as optional — don't provide more secrets than necessary; only FEISHU_APP_ID and FEISHU_APP_SECRET are essential. 2) The script calls ffprobe to measure duration but the metadata only requires ffmpeg; ensure ffprobe is available or add it to the requirements. 3) Review the FEISHU_APP_ID/FEISHU_APP_SECRET usage: installing this skill gives it the ability to obtain tenant tokens and send messages as the app — only grant an app with limited messaging scope and test in a controlled account. 4) Verify you have a safe Python environment with edge-tts installed (pip install edge-tts) and run the script in an isolated environment if you are uncertain. If you want higher assurance, ask the publisher for corrected metadata (declare ffprobe and mark optional env vars as optional) or request a signed / official source URL for the skill.
功能分析
Type: OpenClaw Skill Name: feishu-tts-pro Version: 1.0.0 The feishu-tts-pro skill is a legitimate tool for converting text to speech and sending it via Feishu. It uses Node.js to orchestrate Python (edge-tts) and FFmpeg for audio processing, with all network requests directed to official Feishu API endpoints (open.feishu.cn). The script bin/tts-send.js handles inputs safely using JSON stringification when spawning sub-processes, and no indicators of data exfiltration or malicious intent were found.
能力评估
Purpose & Capability
Name/description, SKILL.md, and the included bin/tts-send.js are consistent: they generate TTS via edge-tts, transcode with FFmpeg, and upload/send audio to Feishu. Requesting FEISHU_APP_ID and FEISHU_APP_SECRET is appropriate for Feishu integration.
Instruction Scope
Runtime instructions and the script stay within the stated scope: they spawn Python to run edge-tts, call ffmpeg/ffprobe for audio processing, write temporary files to the OS temp dir, and call only open.feishu.cn endpoints to upload and send messages. There are no unexpected external endpoints or broad file reads.
Install Mechanism
No install spec (instruction-only with a helper script). The SKILL.md documents installing edge-tts via pip; nothing is downloaded from arbitrary URLs. This is low install risk.
Credentials
Registry metadata lists FEISHU_APP_ID, FEISHU_APP_SECRET, FEISHU_DEFAULT_USER, EDGE_TTS_VOICE, and PYTHON_BIN as required env vars, but SKILL.md and the script treat FEISHU_DEFAULT_USER, EDGE_TTS_VOICE, and PYTHON_BIN as optional (have defaults). The mismatch is confusing and could cause over-provisioning of secrets. The only truly necessary secrets for Feishu are the App ID/Secret.
Persistence & Privilege
always is false and the skill does not request system-wide configuration or permanently modify other skills. The skill uses temporary files and obtains transient tenant_access_token from Feishu — expected behavior for this function.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install feishu-tts-pro
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /feishu-tts-pro 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of feishu-tts-pro. - Converts Chinese text to speech and sends as Feishu audio bubble messages. - Uses Edge-TTS for TTS generation, FFmpeg for audio conversion to ogg/opus. - Supports custom voice, recipient selection, and Python environment configuration. - Requires environment variables for Feishu API and voice settings. - Includes usage guidance, troubleshooting tips, and installation instructions.
元数据
Slug feishu-tts-pro
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

飞书TTS Pro 是什么?

将文字转换为语音并以飞书语音气泡消息发送。使用 Edge-TTS(微软,免费,无限次)生成中文语音,FFmpeg 转码为 ogg/opus,上传到飞书作为 audio 类型消息。支持自定义音色、接收者和 Python 环境。当用户要求用语音回复、发语音消息、TTS 朗读内容时触发。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 40 次。

如何安装 飞书TTS Pro?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install feishu-tts-pro」即可一键安装,无需额外配置。

飞书TTS Pro 是免费的吗?

是的,飞书TTS Pro 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

飞书TTS Pro 支持哪些平台?

飞书TTS Pro 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 飞书TTS Pro?

由 minybear(@minybear)开发并维护,当前版本 v1.0.0。

💬 留言讨论