CapCut Mate 自动化技能
这是一个为 OpenClaw 开发的剪映（CapCut）自动化剪辑技能，通过调用 CapCut Mate API，实现视频草稿的自动化创建、素材导入及云端渲染。
🚀 项目概述
CapCut Mate 是一个完全开源、免费的剪映草稿自动化助手，支持本地部署，让大型语言模型具备基础视频编辑能力。
🛠️ 安装与部署说明
1. 服务端部署（CapCut Mate Server）
方式一：Python 原生部署（推荐）
需确保已安装 Python 3.11+ 和 uv 包管理器。
# 克隆仓库
git clone https://github.com/Hommy-master/capcut-mate.git
cd capcut-mate
# 安装依赖
uv sync
# (Windows 系统需额外执行: uv pip install -e .[windows])
# 启动服务
uv run main.py
*服务启动后，默认端口为 30000。*
方式二：Docker 快速部署
docker-compose pull && docker-compose up -d
⚙️ OpenClaw 技能配置
在你的 OpenClaw 环境 TOOLS.md 中添加 API 地址：
### CapCut Mate 配置
- CAPCUT_MATE_URL: http://localhost:30000/openapi/capcut-mate/v1
📚 完整 API 接口列表
🏗️ 草稿管理
| 接口 | 功能 | 描述 |
|---|
create_draft | 创建草稿 | 创建新的剪映草稿项目，设置画布尺寸 |
save_draft | 保存草稿 | 保存当前草稿状态，确保编辑内容持久化 |
get_draft | 获取草稿 | 获取草稿文件列表和详细信息 |
🎥 视频素材
| 接口 | 功能 | 描述 |
|---|
add_videos | 添加视频 | 批量添加视频素材，支持裁剪、缩放、特效 |
add_images | 添加图片 | 批量添加图片素材，支持动画和转场效果 |
add_sticker | 添加贴纸 | 添加装饰贴纸，支持位置和大小调整 |
🎵 音频处理
| 接口 | 功能 | 描述 |
|---|
add_audios | 添加音频 | 批量添加音频素材，支持音量和淡入淡出 |
get_audio_duration | 获取音频时长 | 获取音频文件的精确时长信息 |
📝 文本字幕
| 接口 | 功能 | 描述 |
|---|
add_captions | 添加字幕 | 批量添加字幕，支持关键词高亮和样式设置 |
add_text_style | 文本样式 | 创建富文本样式，支持关键词颜色和字体 |
✨ 特效与动画
| 接口 | 功能 | 描述 |
|---|
add_effects | 添加特效 | 添加视觉特效，如滤镜、边框、动态效果 |
add_keyframes | 关键帧动画 | 创建位置、缩放、旋转等属性动画 |
add_masks | 遮罩效果 | 添加各种形状遮罩，控制画面可见区域 |
🎨 动画资源查询
| 接口 | 功能 | 描述 |
|---|
get_text_animations | 文本动画 | 获取可用的文本入场、出场、循环动画 |
get_image_animations | 图片动画 | 获取可用的图片动画效果列表 |
🎬 视频生成
| 接口 | 功能 | 描述 |
|---|
gen_video | 生成视频 | 提交视频渲染任务，异步处理 |
gen_video_status | 查询状态 | 查询视频生成任务的进度和状态 |
🚀 快速工具
| 接口 | 功能 | 描述 |
|---|
easy_create_material | 快速创建 | 一次性添加多种类型素材，简化创建流程 |
🛠️ 详细工具类接口
| 接口 | 功能 | 描述 |
|---|
get_url | 提取URL | 从输入内容中提取 URL 信息 |
search_sticker | 搜索贴纸 | 根据关键词搜索贴纸素材 |
objs_to_str_list | 对象转字符串列表 | 将对象列表转换为字符串列表格式 |
str_list_to_objs | 字符串列表转对象 | 将字符串列表转换为对象列表格式 |
str_to_list | 字符串转列表 | 将字符串转换为列表格式 |
timelines | 创建时间线 | 生成视频编辑所需的时间线配置 |
audio_timelines | 音频时间线 | 根据音频时长计算时间线 |
audio_infos | 音频信息 | 根据 URL 和时间线生成音频信息 |
imgs_infos | 图片信息 | 根据 URL 和时间线生成图片信息 |
caption_infos | 字幕信息 | 根据文本和时间线生成字幕信息 |
effect_infos | 特效信息 | 根据名称和时间线生成特效信息 |
keyframes_infos | 关键帧信息 | 根据配置生成关键帧信息 |
video_infos | 视频信息 | 根据 URL 和时间线生成视频信息 |
🛠️ 高级用法：桌面端客户端
如果你需要桌面图形界面，可在项目目录下执行：
# 安装依赖
npm install --verbose
# 启动 Web 开发版
npm run web:dev
# 启动客户端
npm start
💡 开发支持
- Coze 插件: 本项目支持一键导入 Coze 平台作为插件使用。
- 开源社区: 如有疑问，请参阅项目主页的微信交流群。
