内容
# 🎬 ChatCut by OpenClaw
> **用 OpenClaw 操作 ChatCut 的完整教程** —— 让 AI 帮你剪辑视频，从调 MCP 到生成 Motion Graphic 全流程实战
[](https://opensource.org/licenses/MIT)
[](https://chatcut.io)
[](https://openclaw.ai)
[](./docs/03-tool-catalog.md)
---
## 🤔 这是什么？
**ChatCut** 是一个 AI 驱动的视频编辑器，**OpenClaw** 是一个 AI Agent 运行时。两者通过 **Model Context Protocol (MCP)** 连接，让 AI 帮你做视频。
这个项目是**完整实战教程**，从0到1教你：
- 🛠️ **配置 ChatCut MCP** —— 5 分钟打通 OpenClaw ↔ ChatCut
- 🤖 **AI Agent 操作视频** —— 53 个工具一网打尽
- 🎨 **JSX 写 Motion Graphic** —— 直接生成电影级动效
- 🚨 **避坑指南** —— 把我们踩过的 10+ 坑全告诉你
## ⚡ 5 分钟快速开始
### 1. 安装 OpenClaw
```bash
# macOS
brew install openclaw
# 或从 https://openclaw.ai/download 下载
```
### 2. 注册 ChatCut 并配置 MCP
```bash
# 用 OpenClaw 一键添加 ChatCut MCP server
openclaw mcp add chatcut \
--url https://api.chatcut.io/api/external-mcp/mcp \
--auth oauth --transport streamable-http
# 登录（会打开浏览器授权）
openclaw mcp login chatcut
```
### 3. 让 AI 帮你列出你的视频项目
在 OpenClaw 对话框里说：
> "用 chatcut 列一下我的项目"
OpenClaw 会自动调用 `chatcut.list_projects` 工具，把你的项目列表给你。
🎉 **就这样，你已经接通了 ChatCut！**
---
## 🎯 核心能力
| 类别 | 工具数 | 典型用法 |
|---|---|---|
| 📁 项目管理 | 8 | 创建/复制/删除/恢复项目 |
| 🎬 时间线编辑 | 7 | 编辑轨道、切割、移动、标记 |
| 📥 素材导入 | 5 | 本地文件 / URL / S3 预签名 |
| 🎨 Motion Graphic | 4 | **JSX 直接生成电影级动效** |
| 🤖 AI 生成 | 5 | 视频/音乐/配音/音效/着色器 |
| 📝 字幕转录 | 7 | 自动生成字幕 + 去口癖 |
| 🛒 素材检索 | 2 | 搜 Pexels/Pixabay 公共素材 |
| 📤 导出 | 2 | h264/vp8/FCP XML/ProRes |
| 👁️ 预览分析 | 3 | 时间线截图渲染 |
| ⚙️ 任务跟踪 | 2 | 异步 AI 任务状态 |
**完整工具目录** → [`docs/03-tool-catalog.md`](./docs/03-tool-catalog.md)
---
## 📚 教程文档
| 序号 | 主题 | 你将学到 |
|---|---|---|
| 01 | [快速开始](./docs/01-quickstart.md) | 5 分钟接通 ChatCut MCP |
| 02 | [MCP 配置详解](./docs/02-mcp-setup.md) | 4 种连接方式 + OAuth 续期 |
| 03 | [工具目录](./docs/03-tool-catalog.md) | 53 个工具完整清单 |
| 04 | [踩坑总结](./docs/04-pitfalls.md) | 10+ 真实坑 + 解法 |
| 05 | [实用配方](./docs/05-recipes.md) | 5 个端到端场景 |
| 06 | [Motion Graphic 进阶](./docs/06-motion-graphics.md) | JSX 写电影级动效 |
---
## 🚀 实战示例
```bash
cd examples
# 列出你的项目
node 01-list-projects.mjs
# 读时间线
node 02-read-timeline.mjs
# 用 JSX 生成 Motion Graphic（杀手级场景！）
node 03-create-motion-graphic.mjs
# AI 配音
python 04-generate-voice.py
# 搜公共素材
node 06-stock-search.mjs "sunset beach"
# 端到端流水线
node 08-full-pipeline.mjs
```
---
## 🌟 杀手级场景
### 场景 1: 一句话生成电影片头
> "用 ChatCut 给我做一个 5 秒的电影片头，黑色背景配流光金色文字"
AI 会自动：
1. 创建项目
2. 用 JSX 写一个流光文字的 Motion Graphic
3. 放到时间线
4. 导出预览
### 场景 2: 口播视频自动清理
> "把这个 60 分钟的访谈口播自动清掉'嗯''啊'然后压缩静音"
AI 会自动：
1. 上传视频
2. 调用 `clean_script` 去除填充词
3. 压缩静音间隔
4. 重新生成字幕
5. 导出
### 场景 3: 一键 B-Roll 替换
> "在我的'碳中和宣传片'里加 5 段光伏板、风车、森林的 B-Roll"
AI 会自动：
1. 在 stock media 搜光伏板/风车/森林
2. 下载到素材池
3. 在时间线上的 VO 之间插入
4. 自动调整时长
5. 导出
---
## 🛡️ 安全 & 隐私
- **不要把 OAuth token 提交到 Git** —— `.gitignore` 已默认忽略 `.openclaw/` 和 `chatcut-*.json`
- **最小权限原则** —— OpenClaw 只通过 MCP 暴露必要的工具
- **本地优先** —— 所有视频处理在 ChatCut 云端，token 只用于鉴权
---
## 🤝 贡献
欢迎 PR！特别是：
- 新的示例场景
- 更多踩坑案例
- 翻译（English / 日本語 / Español）
- Bug 修复
请先开 Issue 讨论大改动。
---
## 📄 许可证
MIT © 2026 chonpszhou
---
## 🙏 致谢
- [ChatCut](https://chatcut.io) - AI 视频编辑器
- [OpenClaw](https://openclaw.ai) - AI Agent 运行时
- [Model Context Protocol](https://modelcontextprotocol.io) - MCP 协议
---
## ⭐ Star History
如果这个项目帮你少踩了坑，欢迎点 Star ⭐ —— 这是持续更新的最大动力！
