📦 Ali Feishu Sender — 飞书多媒体发送

v1.0.0

通过 API 向飞书发送多媒体内容。适用于:(1) 向飞书用户/群发送图片、音频、视频、富文本或卡片,(2) 上传媒体到飞书,(3) 用户说“发送到飞书”,(4) 发布 MiniMax 生成的内容(图片、TTS、音乐、视频)到飞书。支持内联图片、语音气泡、视频播放器、富文本和交互式卡片。

0· 69·0 当前·0 累计
yuan-huicheng 头像by @yuan-huicheng·MIT-0
下载技能包
License
MIT-0
最后更新
2026/3/29
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
可疑
medium confidence
技能似乎实现了所描述的飞书多媒体发送功能,但其声明的需求(环境变量、可执行文件)与代码和文档不匹配——这种不匹配以及硬编码的 ffmpeg 路径存在问题,在信任凭据或运行之前应该澄清。
评估建议
安装或使用前:1) 不要提供飞书 app_id/app_secret,除非信任该技能——脚本将使用这些来请求租户令牌,然后上传文件到飞书。如有可能,优先提供短期令牌。2) 验证并在需要时更正 ffmpeg/ffprobe 路径——代码默认为 D:\ffmpeg\bin\,这是 Windows 特定路径,可能不存在;ffmpeg 是音频/视频转换所必需的。3) 注意注册表元数据遗漏了 SKILL.md/代码中声明的环境变量和二进制依赖项——要求发布者更正清单,以便明确所需的凭据和二进制文件。4) 在安全环境(如沙箱或隔离 VM)中使用非敏感测试文件审查脚本,以确认行为。5) 注意该工具会读取本地媒体文件并上传到飞书——除非打算将其存储/发送到飞书租户,否则不要用于私人数据。6) 如需更高保证,要求发布者 (a) 记录确切的环境变量,(b) 移除硬编码路径或使其可配置,(c) 从已知来源签名或发布包以便跟踪更新。...
详细分析 ▾
用途与能力
代码实现了飞书媒体上传和消息传递端点(图片、音频→opus 转换、mp4 faststart、富文本、卡片),与技能描述匹配——功能与所述目的一致。然而 SKILL 注册表未列出所需的环境变量/二进制文件,而 SKILL.md 和脚本期望飞书凭据和 ffmpeg/ffprobe(Windows 路径 D:\ffmpeg\bin),这是不一致的。
指令范围
运行时指令和脚本专注于读取本地媒体文件,通过 ffmpeg/ffprobe 转换/检查它们,从飞书获取租户访问令牌,上传文件/图片,以及向飞书 API 发送消息。没有读取无关系统文件、联系意外外部端点或向飞书 API 外泄数据的指令。
安装机制
这是一个仅包含指令的技能,只有一个 Python 脚本,没有安装规范,因此技能本身不会下载或安装任何内容。这降低了安装风险。脚本期望主机上已存在外部二进制文件(ffmpeg/ffprobe)。
凭证需求
注册表元数据声称没有必需的环境变量,但脚本从环境读取 FEISHU_APP_ID、FEISHU_APP_SECRET 和 FEISHU_OPEN_ID(如果没有提供令牌,将调用令牌端点)。SKILL.md 还期望 ffmpeg/ffprobe 位于特定 Windows 路径。请求飞书应用凭据对此用途是合理的,但注册表应该声明它们。这种不匹配是一个实际和安全问题(用户可能不知不觉地提供凭据)。
持久化与权限
技能不请求持久/始终开启的特权(always:false),不修改其他技能或系统级设置。它仅向文档化的飞书 API 端点进行网络调用。
安全有层次,运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发,无需署名。

运行时依赖

无特殊依赖

版本

latestv1.0.02026/3/29

ali-feishu-sender 初始版本。——通过 API 向飞书用户或群发送多媒体(图片、音频、视频、富文本、交互式卡片)。支持内联图片、原生语音气泡(opus+时长)、内联视频播放器(mp4+时长+封面),以及嵌入媒体的富文本。自动处理媒体格式要求(如音频转 opus、视频 faststart、时长提取)。提供函数和 CLI 用于发送内容和上传媒体到飞书。专为轻松发布生成内容(如 MiniMax 图片、音频、视频)到飞书而设计。

无害

安装命令

点击复制
官方npx clawhub@latest install ali-feishu-sender
镜像加速npx clawhub@latest install ali-feishu-sender --registry https://cn.longxiaskill.com

技能文档

Send multimedia messages to Feishu with proper formatting: inline images, voice bubbles, video players, rich text, and cards.

Dependencies

  • ffmpeg at D:\ffmpeg\bin\ffmpeg.exe (for audio conversion, video fix)
  • ffprobe at D:\ffmpeg\bin\ffprobe.exe (for duration detection)
  • Python 3.7+
  • Feishu app credentials (pre-configured in script defaults)

Quick Reference

Run the script at scripts/feishu_media.py:

import sys; sys.path.insert(0, r'/scripts'); from feishu_media import *

Available Functions

FunctionMessage TypeKey Features
send_text(text)textPlain text
send_image(filepath)imageInline embed, auto-detect mime
send_audio(filepath)audioVoice bubble, auto→opus, auto duration
send_video(filepath, cover_image=None)mediaInline player, faststart, auto duration
send_rich_text(title, elements)postRich text with embedded media
send_card(title, elements)interactiveCard with header color
All functions accept optional: open_id, token, app_id, app_secret.

Key Rules (learned from testing)

  • Audio: Must be opus format, must include duration (ms). Auto-converts non-opus via ffmpeg.
  • Video: Must upload as file_type=mp4, must include duration (ms). Script auto-applies -movflags +faststart.
  • Video message type: Use msg_type=media (not video), content uses file_key + optional image_key for cover.
  • Image in video: image_key is the cover thumbnail. Without it, video has no preview frame.
  • Rich text media: Use {'tag': 'media', 'file_key': '...', 'image_key': '...'} as an independent paragraph.
  • File upload types: opus (audio), mp4 (video), stream (generic file), pdf, doc, xls, ppt.

Example: Send MiniMax content to Feishu

# Image
send_image('minimax-output/kitten.png')

# TTS voice bubble (auto converts mp3→opus) send_audio('minimax-output/greeting.mp3')

# Video with cover (auto faststart + duration) send_video('minimax-output/kitten_video.mp4', cover_image='minimax-output/kitten.png')

# Rich text with video send_rich_text('阿离的报告', [ [{'tag': 'text', 'text': '一舞剑气动四方~'}], [{'tag': 'media', 'file_key': 'file_xxx', 'image_key': 'img_xxx'}], ])

CLI Usage

python scripts/feishu_media.py text "Hello"
python scripts/feishu_media.py image photo.png
python scripts/feishu_media.py audio greeting.mp3
python scripts/feishu_media.py video clip.mp4 --cover thumb.png
数据来源ClawHub ↗ · 中文优化:龙虾技能库