OpenMotion 是什么:让编程 Agent 照着参考片重做视频

看到一支节奏很好的产品宣传片,想照着它的镜头和转场给自己的产品做一支,以前要么手动在剪辑软件里抠,要么交给设计师。OpenMotion 把这件事交给你本地的编程 Agent:给它一段参考视频或社交平台链接,它拆镜头、用 HTML 重建画面和转场、换上你的品牌和文案,你在 Studio 时间线里微调,最后渲染成 MP4。项目 11 月 17 日发布 v0.1.0,Apache-2.0 许可,GitHub 已有 1.1 万多星。这篇按官方 README 讲它是什么、怎么接进 Claude Code / Codex、Motion.md 是什么,以及动手前要注意的版权和费用边界。
它是什么
| 仓库 | github.com/nexu-io/openmotion |
|---|---|
| 开发方 | OpenDesign(主页 open-design.ai/motion) |
| 许可证 | Apache-2.0;第三方代码、模板、素材和字体保留各自许可 |
| 热度 | GitHub 11,485 星、1,146 fork(GitHub API,2026-11-18 北京时间) |
| 最新版 | v0.1.0(2026-11-17 17:12 北京时间) |
| 运行环境 | 源码运行需 Git、npm、Node.js 26.11.1;预览和导出还要 Chrome/Chromium 与 FFmpeg/FFprobe |
README 对自己的定位是「Claude Motion 和剪映(CapCut)的开源替代」。流程里有四块:Skills(教 Agent 怎么拆片和重建)、MCP 服务器(模板检索、建项目、编辑、预览、导出等 16 个公开名称)、Studio(时间线编辑器)、渲染引擎。整条创作管线都开源,本地流程不收订阅费或按次渲染费。
Motion.md:把一支片子写成文档
Motion.md 是 OpenMotion 提出的 Markdown 格式,记录镜头顺序、时长、转场,以及哪些素材可以换。思路和 DESIGN.md 类似,后者管视觉规则,Motion.md 管动效和节奏。一份 Motion.md 里有 Brand Kit 一节,写你的品牌身份、语气和确认过的产品事实;Design 一节可以引用独立的 DESIGN.md。
README 给的拆片维度,可以直接当成你给 Agent 的检查清单:
| 研究参考片 | 换成你的故事 |
|---|---|
| 钩子与叙事:先出现什么、接着是什么、靠什么撑到揭晓 | 你的卖点、产品事实和行动号召 |
| 镜头结构:构图、运镜、图层和视觉层级 | 你的 UI、素材、logo 和配图 |
| 动效与节奏:入场、转场、缓动、停顿 | 同样的动效意图,按你的内容调整 |
| 字体与识别:字号层级、配色、构图 | 你的字体、色板和文案 |
| 声音与节奏:语速、音乐节点、重音 | 你的配音、音乐和音效方向 |
想把一个行业或品牌的整套规范打包分享,有 Motion Package v0.2 草案:设计文档、动效文档、素材、依赖声明,外加可选的 SKILL.md。
README 的说法:保留参考片的动效和节奏,同时让成片认得出是你自己的品牌。
怎么装进你的 Agent
最快:装 Skill,让 Agent 自己完成剩下的。用 Vercel 的 Skills CLI:
npx skills add nexu-io/openmotion --skill openmotion
然后对 Agent 说:「Use OpenMotion to install and connect the local Studio and MCP, then help me make a video.」README 特意说明,只装 Skill 只是复制了说明文件,Studio 和 MCP 要等 Agent 按说明装好才算接通。也可以直接让 Agent 读仓库里的 install.md 照做。
手动:从源码跑。
git -c filter.lfs.process= -c filter.lfs.smudge= -c filter.lfs.required=false \
clone --depth 1 --single-branch --branch main https://github.com/nexu-io/openmotion.git
cd openmotion
npm ci
npm run build:studio
npm start
启动后打开终端打印的 studioUrl 或 previewUrl,进 Template library。完整参考视频和可选模板包走 Git LFS,需要时才下载。项目和凭据放在仓库外面,用 MOTION_DATA_DIR 指定工作目录。
接各家 Agent:
- Claude Code:在 MCP 配置里加上下面这段(路径换成绝对路径),再用
/mcp检查连接。 - Codex:在仓库目录里跑
bash scripts/install-motion.command。 - ChatGPT:官方提供一键安装的插件。
- 其他支持本地 stdio MCP 的客户端用同一份配置,
npm run mcp起 stdio 服务。
{
"mcpServers": {
"openmotion": {
"command": "/absolute/path/to/node",
"args": ["--experimental-strip-types", "/absolute/openmotion/mcp.ts"],
"env": { "MOTION_DATA_DIR": "/absolute/openmotion-data" }
}
}
}
接通后的典型用法:先用 openmotion_list_templates 找模板,openmotion_get_template 看详情,openmotion_create_project 建一个可编辑副本。或者在 Studio 里选中模板点 Recreate template,把复制出来的指令发给 Agent。手上已有 HyperFrames 项目的,可以压成 ZIP 从 All projects → Import projects 导进来继续编辑。站内介绍过 HyperFrames,两者都是 HTML 做视频这一路。
动手前看这几条
- 生成素材要花钱。补图、补镜头、配乐、配音会调用你配置的服务商(README 举例 GPT Image 2.6、Seedance 2.5、Suno、Eleven v4),按对方价格计费。只用自己的素材可以不调这些接口。
- 别直接发别人的片子。模板来自大量公司的宣传片拆解,第三方模板、素材和字体各有许可。照着学可以,对外发布要换成你自己的品牌、素材和音乐。
- 认准官方仓库。热门项目容易出仿冒仓库,从 github.com/nexu-io/openmotion 或 open-design.ai 的链接进。
- Node 版本要对。源码运行写明 Node.js 26.11.1,另需 Chromium 和 FFmpeg,缺了预览和导出会失败。MCP 连不上时先看仓库里的连接诊断文档。
- 版本还很早。正式版刚到 v0.1.0,npm 发布版可能落后于仓库主干,命令以最新 README 为准。
适合谁
适合要经常出产品演示片、发布短片的独立开发者和小团队,已经在用 Claude Code 或 Codex,愿意用代码管视频工程。只想偶尔剪个口播,直接用剪辑软件更快;要做的是纯 AI 生成画面而不是动效排版,它也不是首选。
最后
先跑 npx skills add nexu-io/openmotion --skill openmotion,让 Agent 装好 Studio,在模板库里挑一支和你产品类型接近的片子点 Recreate template,只换 logo 和文案导出一版,看看拆出来的 HTML 工程你改不改得动。