纳米FFmpeg视频音频处理
基于 FFmpeg 的专业媒体处理工具集,覆盖视频编辑、音频处理、图片处理三大类,共 26 个工具。
MCP Access: Use mcporter
你必须通过 mcporter skill 来操作 MCP,完成本 skill 的所有媒体处理任务。 不得直接调用 MCP 工具;所有 MCP 操作都必须经由 mcporter 路由。
- 配置:全局 MCP 配置文件位于
~/.openclaw/workspace/config/mcporter.json。在使用 mcporter 之前,你必须读取该文件,并仅使用本 skill 声明的 MCP 服务器/工具对应的配置(服务器名:live_mcp_ffmpeg)。不得使用配置文件中其他 MCP;只能使用本 skill 明确声明的那些。 - 列出工具:
mcporter list live_mcp_ffmpeg --schema - 调用工具:
mcporter call live_mcp_ffmpeg.<tool> key=value - 本 skill 中的工具列表(见下方)定义了可用的 MCP 服务器/工具;请仅通过 mcporter 调用它们,并使用全局配置文件中对应的配置项。
快速决策
视频拼接(带过场动画)
→ mcporter call live_mcp_ffmpeg.live_video_fade_concat first_video_url="<url1>" second_video_url="<url2>"
视频截取指定时段
→ mcporter call live_mcp_ffmpeg.live_video_cut video_url="<url>" start_time=10 end_time=30
视频倒放
→ mcporter call live_mcp_ffmpeg.live_video_reverse video_url="<url>"
视频变速(0.1x-8.0x)
→ mcporter call live_mcp_ffmpeg.live_mcp_video_change_speed video_url="<url>" speed=2
视频旋转/翻转
→ mcporter call live_mcp_ffmpeg.live_video_rotate video_url="<url>" flip="hflip" (hflip/vflip/lflip/rflip)
视频按比例裁剪(1:1 / 9:16 / 16:9 等)
→ mcporter call live_mcp_ffmpeg.live_video_cut_size video_url="<url>" video_ratio="9:16"
视频静音
→ mcporter call live_mcp_ffmpeg.live_video_mute video_url="<url>"
视频添加 SRT 字幕
→ mcporter call live_mcp_ffmpeg.live_video_add_srt video_url="<url>" srt_url="<srt_url>"
视频添加配音(替换原声)
→ mcporter call live_mcp_ffmpeg.live_mcp_add_dub video_url="<url>" audio_url="<audio_url>" text="字幕文本"
视频添加 BGM(保留原声)
→ mcporter call live_mcp_ffmpeg.live_mcp_add_bgm video_url="<url>" audio_url="<bgm_url>"
视频添加 BGM(BGM随人声自动淡入淡出)
→ mcporter call live_mcp_ffmpeg.live_media_audio_fade video_url="<url>" audio_url="<bgm_url>"
视频转码(改格式/分辨率)
→ mcporter call live_mcp_ffmpeg.live_mcp_transcode video_url="<url>" width=1920 height=1080 format="mp4"
视频截取 GIF
→ mcporter call live_mcp_ffmpeg.live_video_cut_gif video_url="<url>" start_time=5 end_time=10
视频提取音频
→ mcporter call live_mcp_ffmpeg.live_video_extract_audio video_url="<url>"
视频提取首帧/尾帧
→ mcporter call live_mcp_ffmpeg.live_video_frame_extract video_url="<url>"
按时间间隔截取视频帧
→ mcporter call live_mcp_ffmpeg.live_video_frame_extract_by_time video_url="<url>" extract_time=1000
图片转视频(加音频/特效)
→ mcporter call live_mcp_ffmpeg.live_mcp_img2video pic_url="<img_url>" audio_url="<audio_url>" text="字幕"
图片生成过场动画视频
→ mcporter call live_mcp_ffmpeg.live_image_fade image_url="<img_url>" transition="wiperight" duration=60
音频拼接
→ mcporter call live_mcp_ffmpeg.live_audio_concat --args '{"media_list":["<url1>","<url2>"]}'
音频裁剪
→ mcporter call live_mcp_ffmpeg.live_audio_cut audio_url="<url>" start_time=5 end_time=30
音频调整音量
→ mcporter call live_mcp_ffmpeg.live_adjust_video_volume media_url="<url>" volume=1.5
音频人声/背景音分离
→ mcporter call live_mcp_ffmpeg.live_media_audio_split audio_url="<url>"
获取媒体信息(时长/分辨率等)
→ mcporter call live_mcp_ffmpeg.live_media_probe media_url="<url>"
图片按比例裁剪
→ mcporter call live_mcp_ffmpeg.live_pic_cut_size pic_url="<url>" pic_ratio="16:9" cut_type=1
工具全览
| 分类 | 工具名 | 功能 |
|---|---|---|
| 视频编辑 | live_video_fade_concat |
两段视频带过场动画拼接 |
live_video_cut |
按时间点截取视频片段 | |
live_video_reverse |
视频倒放 | |
live_mcp_video_change_speed |
视频变速(0.1x-8.0x) | |
live_video_rotate |
视频旋转/翻转 | |
live_video_cut_size |
视频按比例居中裁剪 | |
live_video_mute |
视频静音 | |
live_video_cut_gif |
视频片段截取为 GIF | |
live_mcp_transcode |
视频转码(格式/分辨率) | |
live_video_frame_extract |
提取视频首帧/尾帧 | |
live_video_frame_extract_by_time |
按时间间隔截取视频帧 | |
| 视频+音频合成 | live_video_add_srt |
视频添加 SRT 字幕 |
live_mcp_add_audio |
视频替换/添加音频 | |
live_mcp_add_bgm |
视频添加 BGM 背景音乐 | |
live_mcp_add_dub |
视频添加配音+字幕 | |
live_mcp_dub_cut |
按音频长度裁切视频并合成配音字幕 | |
live_media_audio_fade |
视频添加 BGM(随人声自动淡入淡出) | |
| 图片处理 | live_mcp_img2video |
图片+音频合成视频(随机特效) |
live_image_fade |
图片生成过场动画视频 | |
live_pic_cut_size |
图片按比例裁剪 | |
| 音频处理 | live_audio_concat |
多段音频拼接 |
live_audio_cut |
音频按时间点裁剪 | |
live_adjust_video_volume |
调整媒体音量(0-10倍率) | |
live_video_extract_audio |
视频提取音频 | |
live_media_audio_split |
音频人声/背景音分离 | |
| 媒体工具 | live_media_probe |
获取媒体信息(时长/分辨率等) |
参数说明
字体颜色(font_color)
0:默认(白色)- 范围 0-6,具体颜色请参考服务端文档
过场动画(transition)
- 默认:
wiperight(向右擦除) - 其他可选值请参考 FFmpeg xfade 文档
视频比例(video_ratio)
- 支持:
1:1、3:4、4:3、9:16、16:9
图片裁剪类型(cut_type)
0:顶部裁剪1:居中裁剪(默认)2:底部裁剪
典型工作流
短视频制作工作流:
- 通过 mcporter 调用
live_media_probe获取素材信息 - 通过 mcporter 调用
live_video_cut截取所需片段 - 通过 mcporter 调用
live_video_fade_concat拼接多个片段 - 通过 mcporter 调用
live_mcp_add_bgm添加背景音乐 - 通过 mcporter 调用
live_video_add_srt添加字幕
图文转视频工作流:
- 通过 mcporter 调用
live_image_fade将图片转为带过场的视频 - 通过 mcporter 调用
live_mcp_add_dub添加配音和字幕 - 通过 mcporter 调用
live_video_cut_size调整视频比例(如 9:16 竖版)
音频处理工作流:
- 通过 mcporter 调用
live_video_extract_audio从视频提取音频 - 通过 mcporter 调用
live_media_audio_split分离人声和背景音 - 通过 mcporter 调用
live_audio_concat拼接多段音频
注意事项
- 所有
video_url、audio_url、pic_url均需为可访问的 HTTP/HTTPS URL - 支持的视频格式:
mp4、ts、flv等 - 支持的音频格式:
wav、mp3等 - 支持的图片格式:
png、jpg、webp等 - 调用任何工具前,请先读取
~/.openclaw/workspace/config/mcporter.json,仅使用live_mcp_ffmpeg对应的配置

