README.md - VideoClaw

README.md

1	<p align="center">
2	<img src="video-claw-pics/banner.png" width="100%" />
3	</p>
4
5	<h1 align="center">
6	VideoClaw: AI 创意视频生成员工
7	</h1>
8
9	<p align="center">
10	<b>简体中文</b> \| <a href="./README_EN.md">English</a>
11	</p>
12
13	<h3 align="center">
14	<img src="https://img.shields.io/badge/Version-1.0.0-blue.svg" alt="Version">
15	<a href="https://github.com/HITsz-TMG/VideoClaw/blob/main/LICENSE">
16	<img src="https://img.shields.io/github/license/HITsz-TMG/VideoClaw?style=flat-square" alt="License">
17	</a>
18	<a href="https://github.com/HITsz-TMG/VideoClaw/stargazers">
19	<img src="https://img.shields.io/github/stars/HITsz-TMG/VideoClaw?style=flat-square&logo=github" alt="Stars">
20	</a>
21	<a href="https://github.com/HITsz-TMG/VideoClaw/fork">
22	<img src="https://img.shields.io/github/forks/HITsz-TMG/VideoClaw?style=flat-square&logo=github" alt="Forks">
23	</a>
24	<img src="https://img.shields.io/badge/Python-3.9+-purple.svg" alt="Python">
25	<a href="#openclaw-integration">
26	<img src="https://img.shields.io/badge/OpenClaw-Compatible-ff4444?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTEyIDJDNi40OCAyIDIgNi40OCAyIDEyczQuNDggMTAgMTAgMTAgMTAtNC40OCAxMC0xMFMxNy41MiAyIDEyIDJ6IiBmaWxsPSJ3aGl0ZSIvPjwvc3ZnPg==" alt="OpenClaw Compatible">
27	</a>
28	</h3>
29
30	<p align="center">
31	<b><i><font size="5">直接与 <a href="https://github.com/openclaw/openclaw">OpenClaw</a> 对话："生成 X 的视频" → 搞定。</font></i></b>
32	</p>
33
34	<div align="center">
35
36	📺 [Bilibili](https://space.bilibili.com/2031891503?spm_id_from=333.1007.0.0) ▶️ [YouTube](https://www.youtube.com/@imryanxu) 📖 [集成指南](#方式三openclaw-自动配置) 🦀 [ClawHub](https://clawhub.ai/hit-cxf/video-claw)
37
38	<a href="https://trendshift.io/repositories/24295" target="_blank"><img src="https://trendshift.io/api/badge/repositories/24295" alt="HITsz-TMG%2FVideo-Claw \| Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
39
40	</div>
41
42	# 💥 News
43
44	- `2026/3/27`: 🎬 VideoClaw 正式发布，支持从想法到视频生成全流程自动化，用户可随时介入调整。
45	- `2026/4/9`: ♾️ VideoClaw 针对短剧进行优化，新增无限续写，剧情可自定义。
46	- `2026/4/29`: 🧩 新增解说类短视频、动作迁移、数字人口播三个功能。
47	- `2026/5/8`: ⚙️ 支持通过 WebUI 配置 API 与默认模型，支持一键安装。
48	- `2026/5/13`: 🎞️ 解说类短视频接入 Pixelle-Video 的 HTML 模版。
49	- `2026/6/11`: 🎥 主流程视频生成阶段支持选择视频生成方式，可在首帧生视频、首尾帧生视频、参考图生视频之间切换，并为不同方式分别配置模型。
50
51	# 📖 项目介绍
52
53	<p align="center">
54	<img src="video-claw-pics/workflow_zh.png" width="100%" />
55	</p>
56
57	VideoClaw 是一个面向创意视频生产的 AI 导演系统。你只需要给出一句想法、一个故事梗概，甚至一个模糊概念，系统就会把它拆解为可执行的影视工作流，持续产出可查看、可确认、可修改、可交付的中间资产，最终生成完整成片。
58
59	它不是单点式的文生视频工具，而是一条覆盖剧本策划 → 角色/场景设计 → 分镜规划 → 参考图生成 → 视频生成 → 后期剪辑的全流程生产线。相比只给你一个黑盒结果的闭源视频生成框架，VideoClaw是一个真正可协作的 AI 导演团队：前一阶段决定后一阶段，所有关键节点都能可视化、可编辑、可继续生成。
60
61	# 📺 创作展示
62
63	## 🎬 VideoClaw
64
65	<details>
66	<summary><b>点击查看WebUI界面设计</b></summary>
67
68	\| 阶段 \| 示意图 \| 说明 \|
69	\| ------------- \| -------------------------------------------------------------------- \| -------------------------------------------------------------------------------------------------------------------------------------------------------- \|
70	\| 首页 \| <img src="video-claw-pics/workflow_demo/homepage.png" width="800" /> \| 展示系统概览，支持查看历史项目、创建新项目以及全局配置（API Key 和默认模型设置），是创作流程的起点。 \|
71	\| 剧本策划 \| <img src="video-claw-pics/workflow_demo/stage-1.png" width="800" /> \| 输入创意标题与项目梗概，系统自动生成结构化的多场次剧本（包含旁白与对话），并支持对后续剧情的智能续写。 \|
72	\| 角色/场景设计 \| <img src="video-claw-pics/workflow_demo/stage-2.png" width="800" /> \| 基于剧本自动提取角色与场景的核心特征，生成风格统一的参考原画，作为后续分镜生成的视觉基础。 \|
73	\| 分镜规划 \| <img src="video-claw-pics/workflow_demo/stage-3.png" width="800" /> \| 将每一场剧本拆解为连续的视觉分镜，详细制定镜头视角、动作描述及参考内容，确保叙事连贯性。 \|
74	\| 参考图生成 \| <img src="video-claw-pics/workflow_demo/stage-4.png" width="800" /> \| 为每个分镜场次生成高质量、高精度的参考底图，控制光影细节与画面构图，作为视频生成的关键视觉基准。 \|
75	\| 视频生成 \| <img src="video-claw-pics/workflow_demo/stage-5.png" width="800" /> \| 调用主流高性能视频生成模型（如 Wan、Kling 等）将分镜图转化为动态片段，支持首帧生视频、首尾帧生视频、参考图生视频三种方式。 \|
76	\| 后期剪辑 \| <img src="video-claw-pics/workflow_demo/stage-6.png" width="800" /> \| 聚合所有生成的视频片段，最终一键导出可供发布的成片视频。 \|
77
78	</details>
79
80	### 📱 系列一：程序员被裁后利用 OpenClaw 收购原公司 (写实短剧)
81
82	> 共 8 集，跌宕起伏的逆袭之路（首次生成 6 集 + 续写 2 集）
83
84	<table>
85	<tr>
86	<td align="center" valign="top" width="25%">
87	<a href="https://github.com/user-attachments/assets/1d095b82-3a72-4acc-9ca1-3ff4a6189232">
88	<img src="https://github.com/user-attachments/assets/47b1621e-5c5a-4cb1-9c51-dcf723ac5fda" width="100%" alt="点击播放第 1 集">
89	</a>
90	<br><b>▶️ 第 1 集</b><br>被优化
91	</td>
92	<td align="center" valign="top" width="25%">
93	<a href="https://github.com/user-attachments/assets/489c5343-6345-4bce-81dc-bf6012b9c1cf">
94	<img src="https://github.com/user-attachments/assets/b0dd3781-b767-45c2-9fe2-3dc7421fbf80" width="100%" alt="点击播放第 2 集">
95	</a>
96	<br><b>▶️ 第 2 集</b><br>深夜启程首单突破
97	</td>
98	<td align="center" valign="top" width="25%">
99	<a href="https://github.com/user-attachments/assets/359809cf-678b-429c-bafa-55ff50fd3277">
100	<img src="https://github.com/user-attachments/assets/fcfd191c-61f9-484f-a036-ce717620c827" width="100%" alt="点击播放第 3 集">
101	</a>
102	<br><b>▶️ 第 3 集</b><br>AI获投旧主危机
103	</td>
104	<td align="center" valign="top" width="25%">
105	<a href="https://github.com/user-attachments/assets/5561a04a-5ab3-4099-bc63-2fdbcc48f8e9">
106	<img src="https://github.com/user-attachments/assets/14a535da-b0eb-4b4b-8039-517bac692696" width="100%" alt="点击播放第 4 集">
107	</a>
108	<br><b>▶️ 第 4 集</b><br>收购星耀
109	</td>
110	</tr>
111	<tr>
112	<td align="center" valign="top">
113	<a href="https://github.com/user-attachments/assets/ae4c3618-1990-4ff5-ad85-e09f23b08f7d">
114	<img src="https://github.com/user-attachments/assets/e2d7fbae-d945-461f-be2f-5eb781337cac" width="100%" alt="点击播放第 5 集">
115	</a>
116	<br><b>▶️ 第 5 集</b><br>收购清算新生
117	</td>
118	<td align="center" valign="top">
119	<a href="https://github.com/user-attachments/assets/4ddbb725-34d8-478b-97bc-5d7143f73101">
120	<img src="https://github.com/user-attachments/assets/02a8f7d4-04c9-460e-9ba1-07d594ffcd24" width="100%" alt="点击播放第 6 集">
121	</a>
122	<br><b>▶️ 第 6 集</b><br>新生回望
123	</td>
124	<td align="center" valign="top">
125	<a href="https://github.com/user-attachments/assets/1c1e5970-aaea-44ba-b041-5d551905bfde">
126	<img src="https://github.com/user-attachments/assets/053be420-20e8-423e-8379-f1d1554546c5" width="100%" alt="点击播放第 7 集">
127	</a>
128	<br><b>▶️ 第 7 集</b><br>技术反噬
129	</td>
130	<td align="center" valign="top">
131	<a href="https://github.com/user-attachments/assets/e56e6784-6e49-4891-b0bc-a32308dd2145">
132	<img src="https://github.com/user-attachments/assets/19a50fcd-0a5a-4649-bb63-c7867e945d46" width="100%" alt="点击播放第 8 集">
133	</a>
134	<br><b>▶️ 第 8 集</b><br>坚守伦理共渡难关
135	</td>
136	</tr>
137	</table>
138
139	<br>
140
141	### 🖥️ 系列二：乡村教师 (科幻漫剧)
142
143	> 共 5 集，致敬伟大的文明传承
144
145	<table>
146	<tr>
147	<td align="center" valign="top" width="50%">
148	<a href="https://github.com/user-attachments/assets/1ffe7b06-73e9-44cd-ad3f-afced5239f97">
149	<img src="https://github.com/user-attachments/assets/e1328cf7-23fe-48d8-9ae6-a7beeae6dda9" width="100%" alt="点击播放第 1 集">
150	</a>
151	<br><b>▶️ 第 1 集</b><br>最后一课
152	</td>
153	<td align="center" valign="top" width="50%">
154	<a href="https://github.com/user-attachments/assets/7547e5d3-872c-4344-8727-ee2be109797d">
155	<img src="https://github.com/user-attachments/assets/65bc3866-6405-4033-97b2-54de42a61402" width="100%" alt="点击播放第 2 集">
156	</a>
157	<br><b>▶️ 第 2 集</b><br>清扫计划
158	</td>
159	</tr>
160	<tr>
161	<td align="center" valign="top">
162	<a href="https://github.com/user-attachments/assets/affed408-4df7-4ce7-9681-8f4ed45a6fcf">
163	<img src="https://github.com/user-attachments/assets/81acd075-e4f1-4621-b2dc-b2d87ed83b81" width="100%" alt="点击播放第 3 集">
164	</a>
165	<br><b>▶️ 第 3 集</b><br>临终托付
166	</td>
167	<td align="center" valign="top">
168	<a href="https://github.com/user-attachments/assets/dc7a85a8-6912-4443-a995-3d8f3ca30bc8">
169	<img src="https://github.com/user-attachments/assets/738c539e-8f90-47f5-9983-f3ac35d3d385" width="100%" alt="点击播放第 4 集">
170	</a>
171	<br><b>▶️ 第 4 集</b><br>生死问答
172	</td>
173	</tr>
174	<tr>
175	<td align="center" valign="top">
176	<a href="https://github.com/user-attachments/assets/1fb889c5-0e2b-40fa-a438-7399322ada47">
177	<img src="https://github.com/user-attachments/assets/ce4a1ac4-7308-43ba-a803-fc77b9b9561e" width="100%" alt="点击播放第 5 集">
178	</a>
179	<br><b>▶️ 第 5 集</b><br>文明之光
180	</td>
181	<td align="center" valign="top">
182	<!-- 留空，保持表格边框完整对齐 -->
183	</td>
184	</tr>
185	</table>
186
187	<br>
188
189	### 🎞️ 更多演示
190
191	<details>
192	<summary><b>独立微短剧片段</b></summary>
193
194	<table>
195	<tr>
196	<td align="center" valign="top" width="33%">
197	<video src="https://github.com/user-attachments/assets/63c2f33c-da50-44f0-8c26-a65611479d6a" controls width="100%" preload="none"></video>
198	<br><b>伦敦疑云</b>
199	</td>
200	<td align="center" valign="top" width="33%">
201	<video src="https://github.com/user-attachments/assets/d7c65cad-05b9-46c8-ab0e-96e39909f978" controls width="100%" preload="none"></video>
202	<br><b>一条狗的使命</b>
203	</td>
204	<td align="center" valign="top" width="33%">
205	<video src="https://github.com/user-attachments/assets/ec67546e-2d3d-4b34-b1ad-7d860a9bc1aa" controls width="100%" preload="none"></video>
206	<br><b>无人机系荔枝来</b>
207	</td>
208	</tr>
209	</table>
210
211	</details>
212
213	<br>
214
215	<details>
216	<summary><b>微信交互</b></summary>
217	<div align="center">
218
219	\| \| \| \| \|
220	\| :---------------------------------------------------: \| :---------------------------------------------------: \| :---------------------------------------------------: \| :---------------------------------------------------: \|
221	\| ![WeChat 1](video-claw-pics/wechat_demo/wechat_1.jpg) \| ![WeChat 2](video-claw-pics/wechat_demo/wechat_2.jpg) \| ![WeChat 3](video-claw-pics/wechat_demo/wechat_3.jpg) \| ![WeChat 4](video-claw-pics/wechat_demo/wechat_4.jpg) \|
222
223	</div>
224	</details>
225
226
227
228	<br>
229
230	<details>
231	<summary><b>飞书交互</b></summary>
232	<div align="center">
233
234	\| \| \| \| \|
235	\| :---------------------------------------------------: \| :---------------------------------------------------: \| :---------------------------------------------------: \| :---------------------------------------------------: \|
236	\| ![Feishu 1](video-claw-pics/feishu_demo/feishu_1.jpg) \| ![Feishu 2](video-claw-pics/feishu_demo/feishu_2.jpg) \| ![Feishu 3](video-claw-pics/feishu_demo/feishu_3.jpg) \| ![Feishu 4](video-claw-pics/feishu_demo/feishu_4.jpg) \|
237
238	</div>
239	</details>
240
241	<!--
242	## 🧩 快速创作
243
244	<details>
245	<summary><b>点击查看WebUI界面设计</b></summary>
246
247	\| Pipeline \| 示意图 \| 前端入口 \| 说明 \|
248	\| ---------- \| --------------------------------------------------------------------------------- \| -------------------- \| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ \|
249	\| 文艺短视频 \| <img src="video-claw-pics/pipeline_demo/standard.png" width="600" /> \| 侧边栏「文艺短视频」 \| 支持「图片拼接 / 动态视频」和「创作灵感 / 完整文案」两组模式。系统按句号切分旁白，为每个片段生成配图与语音；图片拼接模式合成图文短视频，动态视频模式继续调用图生视频模型生成片段；可选添加标题和字幕。 \|
250	\| 动作迁移 \| <img src="video-claw-pics/pipeline_demo/action_transfer.png" width="600" /> \| 侧边栏「动作迁移」 \| 输入参考图片、动作视频和提示词，调用支持动作迁移能力的视频模型生成结果视频。 \|
251	\| 数字人口播 \| <img src="video-claw-pics/pipeline_demo/digital_human.png" width="600" /> \| 侧边栏「数字人口播」 \| 输入人物图和口播文案，生成分句语音与数字人视频片段；多片段生成时会使用上一段尾帧衔接下一段，并用生成语音替换最终视频音轨。 \|
252
253	</details>
254
255	### 文艺短视频
256
257	<div align="center">
258	<table align="center" border="0" cellspacing="0" cellpadding="0" style="border:none; border-collapse:collapse; margin:0 auto;">
259	<tr>
260	<td align="center" valign="top" width="25%" style="border:none;"></td>
261	<td align="center" valign="top" width="25%" style="border:none;">
262	<video src="https://github.com/user-attachments/assets/7a674bb7-6ee9-4b83-bfd3-0d880127b632" controls width="100%" preload="none"></video>
263	<br><b>▶️ 山河入梦</b>
264	</td>
265	<td align="center" valign="top" width="25%" style="border:none;">
266	<video src="https://github.com/user-attachments/assets/a62c8184-322d-4c06-b16f-19660766e816" controls width="100%" preload="none"></video>
267	<br><b>▶️ 人生海海</b>
268	</td>
269	<td align="center" valign="top" width="25%" style="border:none;"></td>
270	</tr>
271	</table>
272	</div>
273
274	<br>
275	-->
276
277	# ✨ 功能特性
278
279	\| 能力 \| 说明 \|
280	\| ---------------------------------------- \| --------------------------------------------------------------------------------------------------------------- \|
281	\| 🎬从创意到成片的全流程生成 \| 一条链路打通剧本、角色、分镜、参考图、视频片段与后期剪辑，把零散生成能力升级为完整视频生产工作流。 \|
282	\| 🖼️分镜驱动的可控创作 \| 通过结构化剧本、分镜规划与参考图生成，让角色一致性、镜头表达和画面风格更稳定、更可控。 \|
283	\| ✍️可修改、可续写、可继续生成 \| 支持剧情 / 分镜智能续写，也支持角色、参考图、视频阶段修改后重新生成，避免每次都从头开始。 \|
284	\| 🧩轻量 Pipeline 任务 \| 支持解说短视频、动作迁移、数字人口播三类一次性任务，适合批量生成图文/动态短视频、动作迁移视频和口播视频。 \|
285	\| 📲本地部署、多端协作、产物留存 \| 支持 Web 界面、微信 / 飞书协作、OpenClaw Skill 集成，并对剧本、图片、视频片段和最终成片进行全链路留存。 \|
286
287	### 🎥 视频生成方式
288
289	VideoClaw 主流程第五阶段支持三种视频生成方式，可在首页生成配置、顶栏生成配置或设置页中选择：
290
291	- 首帧生视频：使用第四阶段生成的首帧参考图作为起点，结合分镜提示词生成单个视频片段。推荐优先使用该方式，已经完成过多次测试，表现最稳定。
292	- 首尾帧生视频：使用当前片段参考图作为首帧，并尽量使用下一个片段参考图作为尾帧，适合追求片段之间画面衔接更强的场景。
293	- 参考图生视频：直接读取第二阶段已选人物图和场景图作为参考素材，根据第三阶段片段中的人物与地点信息匹配输入图片，适合强调角色、场景参考一致性的生成。
294
295	---
296
297	# 🚀 快速开始
298
299	## 方式一：一键安装（推荐）
300
301	Linux / MacOS 安装：
302
303	```bash
304	# 1. 克隆项目
305	git clone https://github.com/HITsz-TMG/VideoClaw.git
306	cd VideoClaw
307
308	# 2. 进入应用目录并执行安装脚本
309	cd video-claw/video-claw
310	chmod +x install.sh
311	./install.sh
312
313	# 3. 返回项目根目录
314	cd ../..
315	```
316
317	Windows 安装：
318
319	```bat
320	# 1. 克隆项目
321	git clone https://github.com/HITsz-TMG/VideoClaw.git
322	cd VideoClaw
323
324	# 2. 进入应用目录并执行安装脚本
325	cd video-claw\video-claw
326	install.bat
327
328	# 3. 返回项目根目录
329	cd ../..
330	```
331
332	安装脚本会检查 Python、Node.js、npm 和 ffmpeg，安装后端与前端依赖，复制 `backend/config.yaml.example` 为 `backend/config.yaml`，并执行前端构建。安装完成后，先在 `backend/config.yaml` 中填入模型服务 API Key，并确认 `models` 中的主流程默认模型；也可以启动前端后通过侧边栏底部「设置」页面修改这些配置。配置完成后启动服务：
333
334	```bash
335	# 启动后端
336	cd video-claw/video-claw/backend
337	uv run python api_server.py
338
339	# 新终端启动前端
340	cd video-claw/video-claw/frontend
341	npm start
342	```
343
344	后端默认运行在 `http://localhost:8000`，前端默认运行在 `http://localhost:3000`。
345
346	如果只想安装依赖、暂时跳过前端构建，可以执行：
347
348	```bash
349	AIGC_DIRECTOR_SKIP_FRONTEND_BUILD=1 ./install.sh
350	```
351
352	## 方式二：手动安装
353
354	```bash
355	# 1. 克隆项目
356	git clone https://github.com/HITsz-TMG/Video-Claw.git
357	cd Video-Claw
358
359	# 2. 配置并启动后端
360	cd video-claw/video-claw/backend
361
362	# 安装后端依赖
363	uv sync
364
365	# 配置后端 YAML
366	cp config.yaml.example config.yaml
367	# 编辑 config.yaml 填入 API Key，并确认主流程默认模型
368	# 也可以启动前端后在「设置」页面修改
369
370	# 启动后端
371	uv run python api_server.py
372	# 服务运行在 http://localhost:8000
373	```
374
375	```bash
376	# 3. 配置并启动前端（新终端）
377	cd video-claw/video-claw/frontend
378	npm install
379	npm run build
380	npm start
381	# 访问 http://localhost:3000
382	```
383
384	如果没有安装 `uv`，也可以使用 `python -m venv venv` 与 `pip install -r requirements.txt` 安装后端依赖。
385
386	## 方式三：OpenClaw 自动配置
387
388	向 OpenClaw 发送消息：
389
390	```
391	帮我克隆git仓库：https://github.com/HITsz-TMG/Video-Claw.git
392	然后把Video-Claw中的video-claw文件夹递归复制到.openclaw/workspace/skills目录下，用作AIGC相关的skill
393	```
394
395	使用时建议指明 "使用 video-claw"：
396
397	```
398	用video-claw来生成一个视频，内容是"一条狗的使命"
399	```
400
401	## 方式四：通过 ClawHub 安装
402
403	请确保本地安装了clawhub-cli
404
405	打开终端，输入命令，所有询问均选择yes
406
407	```bash
408	clawhub install video-claw
409	```
410
411	安装完成后，ClawHub 会将 `video-claw` 复制到 `workspace/skills`（或指定的 skills 目录）。
412
413	之后可以参考方式一一键安装或方式二手动安装自行构建项目并运行，也可以使用OpenClaw完成后续项目构建。
414
415	在第一次使用 `video-claw` 时，如果没有手动构建项目，OpenClaw会自动构建前后端并运行，无需手动初始化（构建项目需要配置环境和编译，请耐心等待）。
416
417	---
418
419	# 🔧 配置说明
420
421	<details>
422	<summary><b>点击展开完整环境要求和变量</b></summary>
423
424	## 环境要求
425
426	- Python: 3.9+
427	- Node.js: 18+
428	- npm: 9+
429
430	## 后端配置
431
432	后端配置统一保存在 `video-claw/backend/config.yaml`，采用小写、层级化 YAML 结构。可直接编辑该文件，也可以在前端侧边栏底部进入「设置」页面修改。
433
434	- `api_providers` 保存各模型服务平台的密钥、接口地址和代理开关。
435	- `models` 保存主流程首页使用的默认模型。前端创建项目时会先读取这些默认值，再把具体模型参数传给后端；后端不会再为主流程自动兜底选择模型，缺少模型参数会直接报错。
436	- Pipeline（文艺短视频、动作迁移、数字人口播）不使用这里的主流程默认模型，需要在对应 Pipeline 页面单独选择模型。
437
438	## 前端设置页面
439
440	启动前后端后，可以在 Web 前端左侧边栏底部进入「设置」页面，无需手动编辑 YAML，也可以完成常用配置：
441
442	- 填写或更新 OpenAI、Gemini、DeepSeek、DashScope、火山方舟 ARK、Kling 等平台的 API Key / Access Key / Secret Key。
443	- 修改各 provider 的 `base_url`、`enable_proxy`，以及公共代理地址 `api_providers.common.proxy`。
444	- 选择主流程默认模型，包括 `llm`、`vlm`、`image_t2i`、`image_it2i`，以及首帧生视频、首尾帧生视频、参考图生视频三类视频模型。
445	- 在「视频生成配置」中设置主流程默认风格、视频长宽比、视频分辨率和视频生成方式；推荐默认使用 `first_frame`（首帧生视频），完成过多次测试，最稳定。
446	- 保存后会写回 `backend/config.yaml`。API Key、代理和默认模型会被后续新建项目读取；`server.host`、`server.port` 等服务启动参数需要重启后端后完全生效。
447
448	```yaml
449	project_name: Video-Claw
450
451	server:
452	host: 127.0.0.1
453	port: 8000
454	log_level: INFO
455	access_log: false
456
457	api_providers:
458	common:
459	print_model_input: false
460	proxy: ''
461	openai:
462	api_key: your_openai_key
463	base_url: https://api.openai.com/v1
464	enable_proxy: false
465	gemini:
466	api_key: your_gemini_key
467	base_url: https://generativelanguage.googleapis.com/v1beta
468	enable_proxy: false
469	deepseek:
470	api_key: your_deepseek_key
471	base_url: https://api.deepseek.com/v1
472	enable_proxy: false
473	dashscope:
474	api_key: your_dashscope_key
475	base_url: https://dashscope.aliyuncs.com/api/v1
476	enable_proxy: false
477	ark:
478	api_key: your_ark_key
479	base_url: https://ark.cn-beijing.volces.com/api/v3
480	enable_proxy: false
481	kling:
482	access_key: your_kling_access_key
483	secret_key: your_kling_secret_key
484	enable_proxy: false
485
486	models:
487	llm: qwen3.5-plus
488	vlm: qwen3.5-plus
489	image_t2i: doubao-seedream-5-0-260128
490	image_it2i: doubao-seedream-5-0-260128
491	video: wan2.7-i2v
492	video_first_frame: wan2.7-i2v
493	video_start_end: wan2.7-i2v
494	video_reference: wan2.7-r2v
495
496	generation:
497	style: realistic
498	video_ratio: '16:9'
499	video_resolution: 720P
500	video_generation_mode: first_frame
501	```
502
503	<!-- `api_providers.common.proxy` 是唯一的代理地址。每个 provider 通过 `enable_proxy` 决定是否启用该代理，默认关闭，避免同一进程内不同模型调用互相污染。`server.host` / `server.port` 等服务启动参数保存后需要重启后端才会完全生效；API Key、代理配置和 `models` 中的主流程默认模型会被新的项目创建和模型调用读取。 -->
504
505	## 密钥与模型对应关系
506
507	\| 平台 \| 配置字段 \| 常用用途 \|
508	\| :--------------------: \| :----------------------------------------------------------------- \| :----------------------------------- \|
509	\| OpenAI \| `api_providers.openai.api_key` / `base_url` \| GPT 文本、视觉模型和 OpenAI 图像模型 \|
510	\| Gemini \| `api_providers.gemini.api_key` / `base_url` \| Gemini 文本、视觉模型 \|
511	\| DeepSeek \| `api_providers.deepseek.api_key` / `base_url` \| DeepSeek 文本模型 \|
512	\| DashScope \| `api_providers.dashscope.api_key` / `base_url` \| 通义千问、通义万相、Wan 图像/视频等 \|
513	\| 火山方舟 ARK \| `api_providers.ark.api_key` / `base_url` \| Seedream 图像、Seedance 视频等 \|
514	\| Kling \| `api_providers.kling.access_key` / `secret_key` / `base_url` \| 可灵视频生成 \|
515
516	只需要填写你实际选择模型所需的平台密钥。例如主流程默认图像模型是 `doubao-seedream-` 时，需要配置 `ark.api_key`；默认视频模型是 `wan` 时，需要配置 `dashscope.api_key`。如果在 Pipeline 页面选择了不同模型，也要确保对应平台的密钥已经填写。
517
518	## 可用模型
519
520	\| 类型 \| 模型 \|
521	\| :----------------: \| :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- \|
522	\| LLM \| qwen3.6-max-preview, qwen3-max, deepseek-chat, deepseek-reasoner, deepseek-v4-flash, deepseek-v4-pro, gpt-4o, gpt-5, gpt-5.4, gemini-2.5-flash, gemini-2.0-flash, kimi-k2.6 \|
523	\| VLM \| qwen3.6-plus, qwen3.6-flash, kimi-k2.6, gpt-5.4, gemini-2.5-flash-image, gemini-2.0-flash \|
524	\| 文生图 \| wan2.7-image, wan2.7-image-pro, wan2.6-t2i, doubao-seedream-5.0/4.5/4.0, gpt-image-2 \|
525	\| 图生图 \| wan2.7-image, wan2.7-image-pro, doubao-seedream-5.0/4.5/4.0, gpt-image-2 \|
526	\| 视频生成 \| 首帧生视频：wan2.7-i2v, wan2.6-i2v-flash, doubao-seedance-2.0 (Normal/Fast), kling-v3/v2.6/v2.5；首尾帧生视频：wan2.7-i2v 等支持首尾帧输入的模型；参考图生视频：wan2.7-r2v 等支持参考图输入的模型。 \|
527
528	模型信息以 `video-claw/video-claw/backend/models/config_model.py` 为准。前端和 Pipeline API 会根据模型能力标签筛选模型，例如文本生成、图像生成、图生视频、动作迁移、TTS 等。
529
530	</details>
531
532	# 产物说明
533
534	Video-Claw 的所有任务元数据与生成产物均保存在 `video-claw/video-claw/backend/code/` 目录下。
535
536	<details>
537	<summary><b>点击展开存储结构与标识说明</b></summary>
538
539	## 📁 存储结构
540
541	```text
542	video-claw/video-claw/backend/code/
543	├── data/
544	│ ├── tasks/ # Pipeline 任务元数据 (JSON)
545	│ └── sessions/ # AIGC-Claw 会话元数据 (JSON)
546	└── result/
547	├── task/ # Pipeline 生成产物 (按 Task ID 分类)
548	│ └── <task_id>/ # e.g., 20260514_204946_961f95d9
549	│ ├── audio_xx.mp3 # 分段音频
550	│ ├── video_xx.mp4 # 分段视频
551	│ ├── storyboard.json # 故事板数据
552	│ └── final.mp4 # 最终合成视频
553	├── image/ # AIGC-Claw 生成的图片
554	│ └── <session_id>/ # 按会话 ID 分类
555	│ ├── Assets/ # 角色与场景素材
556	│ │ ├── characters/ # 角色参考图
557	│ │ └── settings/ # 场景参考图
558	│ └── Scenes/ # 生成的分镜参考图
559	├── video/ # AIGC-Claw 生成的视频
560	│ └── <session_id>/ # 按会话 ID 分类
561	└── script/ # AIGC-Claw 生成的剧本/分镜数据
562	```
563
564	## 🆔 标识说明
565
566	- Task ID: 格式为 `YYYYMMDD_HHMMSS_随机Hash` (例如 `20260514_204946_961f95d9`)，用于唯一标识一次 Pipeline 任务。
567	- Session ID: 毫秒级时间戳 (如 `1778810088325`)，用于关联主流程交互中的上下文数据与生成图片。
568
569	</details>
570
571	# 🙏 致谢
572
573	Video-Claw 的想法和设计受到了 [Pixelle-Video](https://github.com/AIDC-AI/Pixelle-Video)、[AutoResearchClaw](https://github.com/aiming-lab/AutoResearchClaw)、[huobao-drama](https://github.com/chatfire-AI/huobao-drama)、[Flova](https://www.flova.ai) 与 [libtv-skills](https://github.com/libtv-labs/libtv-skills) 的启发。
574
575
576	# 📚 系列工作
577
578	\| 框架图 \| 论文信息 \|
579	\| :---: \| :--- \|
580	\| <img src="./FilmAgent-pics/framework.png" width="420" alt="FilmAgent framework"/> \| [SIGGRAPH Asia 2024] FilmAgent: Automating Virtual Film Production Through a Multi-Agent Collaborative Framework<br>Zhenran Xu, Jifang Wang, Longyue Wang, Zhouyi Li, Senbao Shi, Baotian Hu, Min Zhang<br>[[Paper](https://doi.org/10.1145/3681758.3698014)] [[GitHub](https://github.com/HITsz-TMG/Video-Claw/blob/main/FilmAgent.md)] \|
581	\| <img src="https://github.com/HITsz-TMG/Anim-Director/blob/main/Anim-Director/assets/visualeg.png" width="420" alt="Anim-Director result"/> \| [SIGGRAPH Asia 2024] Anim-Director: A Large Multimodal Model Powered Agent for Controllable Animation Video Generation<br>Yunxin Li, Haoyuan Shi, Baotian Hu, Longyue Wang, Jiashun Zhu, Jinyi Xu, Zhen Zhao, Min Zhang<br>[[Paper](https://doi.org/10.1145/3680528.3687688)] [[GitHub](https://github.com/HITsz-TMG/Anim-Director/tree/main/Anim-Director)] \|
582	\| <img src="https://raw.githubusercontent.com/HITsz-TMG/Anim-Director/main/AniMaker/assets/pipeline.png" width="420" alt="AniMaker pipeline"/> \| [SIGGRAPH Asia 2025] AniMaker: Multi-Agent Animated Storytelling with MCTS-Driven Clip Generation<br>Haoyuan Shi, Yunxin Li, Xinyu Chen, Longyue Wang, Baotian Hu, Min Zhang<br>[[Paper](https://doi.org/10.1145/3757377.3764009)] [[GitHub](https://github.com/HITsz-TMG/Anim-Director/tree/main/AniMaker)] \|
583
584	<p align="center">
585	<sub>Built with 🦞 by the Lychee Agent team</sub>
586	</p>
587

587 lines MARKDOWN