← 返回 Skills 市场
114
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install feishu-video-editor
功能描述
基于飞书平台,支持视频下载、语音识别、静音检测、智能裁剪、字幕生成及自动上传功能的视频编辑工具。
使用说明 (SKILL.md)
飞书 AI 视频剪辑 Skill - MVP
⚡ OpenClaw Skill 大师培训体系 - 实战项目
📋 概述
本 Skill 实现基于飞书的 AI 视频剪辑功能,支持语音识别、智能裁剪、字幕生成等核心功能。
MVP 功能范围
| 功能 | 状态 | 说明 |
|---|---|---|
| 视频下载 | ✅ | 从飞书云空间下载视频 |
| 语音转文字 | ✅ | 使用 Whisper 进行 ASR |
| 静音检测 | ✅ | 自动识别并删除静音片段 |
| 视频裁剪 | ✅ | 基于时间戳裁剪视频 |
| 字幕生成 | ✅ | 自动生成 SRT 字幕 |
| 结果上传 | ✅ | 剪辑完成自动上传到飞书 |
🏗️ 架构设计
核心流程
用户上传视频到飞书
↓
发送指令:@视频助手 剪辑这个视频
↓
Skill 下载视频到本地
↓
AI 分析(语音识别 + 静音检测)
↓
生成剪辑方案
↓
FFmpeg 执行剪辑
↓
上传结果到飞书云空间
↓
返回剪辑后的视频链接
技术栈
| 组件 | 技术选型 |
|---|---|
| 视频处理 | FFmpeg |
| 音频分析 | librosa, pydub |
| 语音识别 | Whisper (openai-whisper) |
| 字幕生成 | pysrt |
| 飞书集成 | 飞书开放 API |
🚀 安装与配置
步骤 1:安装系统依赖
# Ubuntu/Debian
sudo apt update && sudo apt install -y ffmpeg
# macOS
brew install ffmpeg
# CentOS/RHEL
sudo yum install -y ffmpeg
步骤 2:安装 Skill
claw skill install feishu-video-editor
步骤 3:安装 Python 依赖
cd ~/openclaw-skills/feishu-video-editor
pip install -r requirements.txt
步骤 4:配置
编辑 config.json:
{
"whisper_model": "base",
"output_dir": "~/Videos/edited",
"auto_upload": true,
"silent_threshold": -50,
"min_silent_duration": 1.0
}
💡 使用示例
示例 1:删除静音片段
你:@视频助手 把这个视频中的静音部分剪掉
视频助手:🎬 开始处理视频...
视频助手:📊 检测到 5 段静音,总时长 12 秒
视频助手:✂️ 剪辑完成!
视频助手:✅ 已上传到云空间:[剪辑后的视频.mp4](链接)
示例 2:按时间裁剪
你:@视频助手 裁剪视频 00:01:30 到 00:02:45
视频助手:✂️ 裁剪中...
视频助手:✅ 完成!时长:1 分 15 秒
示例 3:生成字幕
你:@视频助手 给这个视频生成字幕
视频助手:🎤 语音识别中...
视频助手:📝 生成字幕文件...
视频助手:✅ 字幕已生成:[字幕.srt](链接)
示例 4:提取音频
你:@视频助手 提取这个视频的音频
视频助手:🎵 提取中...
视频助手:✅ 音频已提取:[音频.mp3](链接)
🔧 可用命令
| 命令 | 说明 | 示例 |
|---|---|---|
/video_editor trim_silence |
删除静音片段 | 上传视频后发送 |
/video_editor crop |
按时间裁剪 | crop 00:01:00 00:02:30 |
/video_editor subtitle |
生成字幕 | 上传视频后发送 |
/video_editor extract_audio |
提取音频 | 上传视频后发送 |
/video_editor merge |
合并多个视频 | merge video1.mp4 video2.mp4 |
/video_editor help |
显示帮助 | - |
⚙️ 配置说明
config.json
{
"whisper_model": "base",
"output_dir": "~/Videos/edited",
"auto_upload": true,
"silent_threshold": -50,
"min_silent_duration": 1.0,
"ffmpeg_preset": "medium",
"max_file_size_mb": 100
}
配置项说明
| 参数 | 默认值 | 说明 |
|---|---|---|
whisper_model |
base | Whisper 模型:tiny/base/small/medium/large |
output_dir |
~/Videos/edited | 输出目录 |
auto_upload |
true | 自动上传到飞书云空间 |
silent_threshold |
-50 | 静音检测阈值(dB) |
min_silent_duration |
1.0 | 最小静音时长(秒) |
ffmpeg_preset |
medium | FFmpeg 编码预设 |
max_file_size_mb |
100 | 最大文件大小限制 |
📊 性能参考
| 视频时长 | 处理时间(M1 Mac) | 处理时间(Intel i7) |
|---|---|---|
| 1 分钟 | ~30 秒 | ~60 秒 |
| 5 分钟 | ~2 分钟 | ~5 分钟 |
| 10 分钟 | ~5 分钟 | ~12 分钟 |
注意: Whisper 语音识别是主要耗时步骤。
⚠️ 注意事项
1. 文件大小限制
飞书云空间单文件限制 100MB,超过需要:
- 压缩视频质量
- 或分段处理
2. 处理时长
视频剪辑是 CPU 密集型任务:
- 建议在服务器端运行
- 或设置超时限制(默认 10 分钟)
3. 隐私考虑
视频会下载到本地处理:
- 处理完成后自动清理
- 敏感视频建议本地运行
🔄 后续优化(TODO)
- 支持更多视频格式
- 添加视频压缩功能
- 智能高光检测
- 转场效果
- 批量处理
- 云端分布式处理
- 视频预览卡片
📝 版本历史
| 版本 | 日期 | 更新内容 |
|---|---|---|
| v1.0.0 | 2026-03-21 | MVP 版本,核心功能实现 |
🎓 学习价值
本 Skill 涵盖:
- ✅ FFmpeg 视频处理
- ✅ Whisper 语音识别
- ✅ 音频分析(librosa)
- ✅ 飞书云空间 API
- ✅ 异步任务处理
- ✅ 文件上传下载
作者: Spark ⚡
创建时间: 2026-03-21
GitHub: https://github.com/rfdiosuao/openclaw-skills/tree/main/feishu-video-editor
安全使用建议
What to consider before installing or running this skill:
- Feishu integration mismatch: The documentation promises downloading from and uploading to Feishu cloud, but the code does not show any Feishu API usage or request Feishu credentials. Expect that upload/download to Feishu will not work out-of-the-box. Ask the author for how Feishu auth should be provided (e.g., APP_ID/APP_SECRET or access token) and request a code path that uses those credentials.
- Local execution & data exposure: The skill downloads/reads video files locally and writes temporary files (e.g., /tmp/*.json, temp audio/video clips). If you run this on sensitive videos, they will be processed locally and may be stored temporarily — run in an isolated environment if needed.
- Model and network usage: Installing requirements installs openai-whisper and friends; loading Whisper will likely download model weights from the network and consume a lot of disk and bandwidth. Plan for this and run inside a controlled environment.
- Shell injection risk: src/index.ts builds and execs a shell command by concatenating unescaped arguments. If a video path or other argument can be influenced by an untrusted user, this could allow command injection. Before using, patch runPythonScript to use execFile/spawn with an argument array (no shell interpolation) or properly sanitize/escape inputs.
- Code completeness: The Python file posted is truncated but mostly does local processing. Review the full video_processor.py for any network calls, hidden endpoints, or unexpected behavior. Confirm there is no hard-coded upload endpoint or credentials in other parts of the repository.
- Mitigations if you want to use it: run inside a dedicated unprivileged VM/container; review and fix the exec invocation to avoid shell interpolation; require and document Feishu credentials and implement/verify Feishu upload/download flows; run pip installs inside a virtualenv; test with non-sensitive sample videos first.
Given the inconsistencies and the command-execution risk, treat this skill as suspicious until the Feishu integration and safe execution model are clarified and the shell-invocation issue is corrected.
功能分析
Type: OpenClaw Skill
Name: feishu-video-editor
Version: 1.0.0
The skill contains a significant shell injection vulnerability in `src/index.ts` within the `runPythonScript` function, where user-provided arguments (such as file paths and timestamps) are concatenated into a shell command string and executed via `child_process.exec` without sanitization. While the Python backend (`src/video_processor.py`) uses safer `subprocess.run` list-based calls for FFmpeg, the TypeScript entry point's use of a raw shell string allows for arbitrary command execution. The functionality itself (video editing via FFmpeg and Whisper) appears legitimate and aligned with the documentation, but the lack of input validation makes it highly vulnerable.
能力评估
Purpose & Capability
SKILL.md and README claim full Feishu integration (download from Feishu cloud, upload results). However the repository and runtime code do not declare or use Feishu API credentials, do not read environment variables for Feishu, and no HTTP calls / Feishu SDK usage are present in the visible TypeScript or Python code. That mismatch (cloud integration stated but not implemented or not requesting required credentials) is incoherent.
Instruction Scope
Runtime instructions in SKILL.md describe downloading from and uploading to Feishu, but src/index.ts and the visible portion of src/video_processor.py operate on local file paths only and expect a local videoPath. The instructions also instruct installing pip deps (openai-whisper) and ffmpeg which is consistent with local processing, but the Feishu-specific parts are not implemented in code or not tied to declared credentials. The SKILL.md also reasonably informs that video files are downloaded to local disk and cleaned up afterwards — that is expected, but it means local files will be processed and transiently written to /tmp.
Install Mechanism
There is no install spec in the skill bundle (instruction-only installer), but code files are included. Dependencies are installed via requirements.txt (openai-whisper, librosa, etc.) which will download Python packages and (when using Whisper) may trigger large model downloads at runtime. This is expected for the stated features but is heavier than a tiny utility and implies large network downloads and storage needs.
Credentials
The skill requests no environment variables or credentials despite advertising Feishu cloud upload/download; a Feishu-integrated tool would normally require app credentials/tokens. Separately, src/index.ts constructs a shell command string `python3 ${args.join(' ')}` and runs it through exec — if any argument (e.g., videoPath) is attacker-controlled or contains shell metacharacters this enables command injection. The Python side runs ffmpeg via subprocess (usually as lists, which is safer).
Persistence & Privilege
The skill does not request elevated persistence: always is false, there is no indication it will forcibly persist or modify other skills' configurations. It writes temporary config files to /tmp for each run (predictable but standard for a local tool).
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install feishu-video-editor - 安装完成后,直接呼叫该 Skill 的名称或使用
/feishu-video-editor触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
飞书 AI 视频剪辑 Skill v1.0.0 发布
- 支持飞书云空间视频下载与自动上传,方便协作分享
- 集成 Whisper 语音识别,实现视频自动生成字幕
- 智能静音检测与自动裁剪,去除无声片段
- 基于时间戳灵活裁剪视频
- 自动生成、上传 SRT 字幕文件
- 命令支持音频提取与多视频合并,操作简单
- MVP 版已覆盖主流视频编辑基础流程
元数据
常见问题
Feishu Video Editor 是什么?
基于飞书平台,支持视频下载、语音识别、静音检测、智能裁剪、字幕生成及自动上传功能的视频编辑工具。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 114 次。
如何安装 Feishu Video Editor?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install feishu-video-editor」即可一键安装,无需额外配置。
Feishu Video Editor 是免费的吗?
是的,Feishu Video Editor 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Feishu Video Editor 支持哪些平台?
Feishu Video Editor 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Feishu Video Editor?
由 rfdiosuao(@rfdiosuao)开发并维护,当前版本 v1.0.0。
推荐 Skills