← Back to Skills Marketplace
rfdiosuao

Feishu Video Editor

by rfdiosuao · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
114
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install feishu-video-editor
Description
基于飞书平台,支持视频下载、语音识别、静音检测、智能裁剪、字幕生成及自动上传功能的视频编辑工具。
README (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

Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install feishu-video-editor
  3. After installation, invoke the skill by name or use /feishu-video-editor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
飞书 AI 视频剪辑 Skill v1.0.0 发布 - 支持飞书云空间视频下载与自动上传,方便协作分享 - 集成 Whisper 语音识别,实现视频自动生成字幕 - 智能静音检测与自动裁剪,去除无声片段 - 基于时间戳灵活裁剪视频 - 自动生成、上传 SRT 字幕文件 - 命令支持音频提取与多视频合并,操作简单 - MVP 版已覆盖主流视频编辑基础流程
Metadata
Slug feishu-video-editor
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Feishu Video Editor?

基于飞书平台,支持视频下载、语音识别、静音检测、智能裁剪、字幕生成及自动上传功能的视频编辑工具。 It is an AI Agent Skill for Claude Code / OpenClaw, with 114 downloads so far.

How do I install Feishu Video Editor?

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

Is Feishu Video Editor free?

Yes, Feishu Video Editor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Feishu Video Editor support?

Feishu Video Editor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Feishu Video Editor?

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

💬 Comments