Capcut Mate Skill

Automate CapCut video editing by creating projects, adding videos, and rendering final videos via the CapCut Mate API.

CapCut Mate 自动化技能

这是一个为 OpenClaw 开发的剪映（CapCut）自动化剪辑技能，通过调用 CapCut Mate API，实现视频草稿的自动化创建、素材导入及云端渲染。

🚀 项目概述

CapCut Mate 是一个完全开源、免费的剪映草稿自动化助手，支持本地部署，让大型语言模型具备基础视频编辑能力。

🛠️ 安装与部署说明

1. 服务端部署（CapCut Mate Server）

方式一：Python 原生部署（推荐）

需确保已安装 Python 3.11+ 和 uv 包管理器。

bash

# 克隆仓库
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 快速部署

bash

docker-compose pull && docker-compose up -d

---

⚙️ OpenClaw 技能配置

在你的 OpenClaw 环境 TOOLS.md 中添加 API 地址：

markdown

### 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 和时间线生成视频信息

---

🛠️ 高级用法：桌面端客户端

如果你需要桌面图形界面，可在项目目录下执行：

bash

# 安装依赖
npm install --verbose
# 启动 Web 开发版
npm run web:dev
# 启动客户端
npm start

💡 开发支持

• Coze 插件: 本项目支持一键导入 Coze 平台作为插件使用。
• 开源社区: 如有疑问，请参阅项目主页的微信交流群。