Excalibur9527/capcut-mate-skill

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 平台作为插件使用。
• 开源社区: 如有疑问，请参阅项目主页的微信交流群。