Boxed FFmpeg_设计多媒体 skill-PHP中文网

Boxed FFmpeg

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

音视频信息提取、格式转换、音频提取，使用 FFmpeg WASM 沙箱。

框式FFmpeg Skill.

功能概述

框式FFmpeg Skill.是一项面向实际任务的技能，主要用于Run FFmpeg 命令安全地在一个WASM沙盒内进行音频/视频处理. 1. 调试. 当用户说: 1. “ffmpeg ” , “媒体信息”, “获取视频信息”. 1 . “conv ” 时使用此技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；

使用与执行

若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；

结果检查与注意事项

涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

封装式 FFmpeg 技能

在 WASM 沙箱中安全运行 FFmpeg 命令，用于音视频处理。

触发方式

当用户说出以下任一内容时，启用该技能：

"ffmpeg"、"media info"、"get video information"
"convert video"、"change video format"、"格式转换"
"extract audio"、"audio from video"、"提取音频"
"boxed-ffmpeg"

⚠️ 必需插件

本技能依赖 openclaw-wasm-sandbox 插件，版本需为 >= 0.2.0。

openclaw plugins install clawhub:openclaw-wasm-sandbox
openclaw plugins update openclaw-wasm-sandbox
openclaw gateway restart

⚠️ 需要 WASM 文件

若本地尚无 WASM 文件，请先下载：

wasm-sandbox-download({
  url: "https://raw.githubusercontent.com/guyoung/wasm-sandbox-openclaw-skills/main/boxed-ffmpeg/files/boxed-ffmpeg-component.wasm",
  output: "~/.openclaw/skills/boxed-ffmpeg/files/boxed-ffmpeg-component.wasm",
  resume: false,
  timeout: 120000
})

工具：wasm-sandbox-run

wasm-sandbox-run({
  wasmFile: "~/.openclaw/skills/boxed-ffmpeg/files/boxed-ffmpeg-component.wasm",
  workDir: "",
  args: ["", "", ""]
})

重要说明：

workDir 必须设为输入文件所在目录
输入/输出参数仅支持纯文件名（不包含路径）

支持命令

命令	说明	参数
`info`	获取媒体文件信息
`convert`	转换视频格式
`extract-audio`	从视频中提取音频

使用示例

获取媒体信息

用户说：“获取 video.mp4 的信息”（文件位于 workspace 根目录）

wasm-sandbox-run({
  wasmFile: "~/.openclaw/skills/boxed-ffmpeg/files/boxed-ffmpeg-component.wasm",
  workDir: "/home/user/.openclaw/workspace",
  args: ["info", "video.mp4"]
})

转换视频格式

用户说：“将 video.mp4 转换为 AVI 格式”（文件位于 workspace 根目录）

wasm-sandbox-run({
  wasmFile: "~/.openclaw/skills/boxed-ffmpeg/files/boxed-ffmpeg-component.wasm",
  workDir: "/home/user/.openclaw/workspace",
  args: ["convert", "video.mp4", "video.avi"]
})

从视频中提取音频

用户说：“从 video.mp4 中提取音频并保存为 mp3”（文件位于 workspace 根目录）

wasm-sandbox-run({
  wasmFile: "~/.openclaw/skills/boxed-ffmpeg/files/boxed-ffmpeg-component.wasm",
  workDir: "/home/user/.openclaw/workspace",
  args: ["extract-audio", "video.mp4", "audio.mp3"]
})

在子目录中执行转换

用户说：“将 videos/input.mp4 转换为 videos/output.avi”

wasm-sandbox-run({
  wasmFile: "~/.openclaw/skills/boxed-ffmpeg/files/boxed-ffmpeg-component.wasm",
  workDir: "/home/user/.openclaw/workspace/videos",
  args: ["convert", "input.mp4", "output.avi"]
})