Capcut Mate Skill OpenClaw Skill
Automate CapCut video editing by creating projects, adding videos, and rendering final videos via the CapCut Mate API.
Installation
clawhub install capcut-mate-skill
Requires npm i -g clawhub
842
Downloads
3
Stars
4
current installs
4 all-time
2
Versions
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 平台作为插件使用。
- 开源社区: 如有疑问，请参阅项目主页的微信交流群。
Statistics
Author
Excalibur9527
@excalibur9527
Latest Changes
v0.1.1 · Mar 12, 2026
- Major documentation update: SKILL.md now includes comprehensive installation, deployment, API overview, configuration, and advanced usage instructions in Chinese. - Expanded API list: All available CapCut Mate API endpoints and their functionalities are now documented. - Installation and deployment instructions now detail both native Python and Docker methods. - OpenClaw skill configuration and advanced desktop client usage are clearly outlined.
Quick Install
clawhub install capcut-mate-skill Related Skills
Other popular skills you might find useful.
Made in Europe Chat with 100+ AI Models in one App.
Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.
