Hilight Video Generator Skill
触发条件
用户出现以下意图时触发：
- 生成视频、制作视频、做视频、创建视频
- 电商视频、营销视频、产品视频、短视频
- video, generate video, marketing video
- 查询视频进度、视频状态
- 下载视频
绝对禁止
- 绝对禁止 在回复中明文输出 API Key。
- 绝对禁止 把 API Key 写入日志、命令历史、聊天记录中。
- 绝对禁止 在未实际调用 MCP 的情况下声称"已生成"或"已完成"。
- 绝对禁止 伪造视频 URL 或任务状态。
前置条件
本技能依赖 mcporter 连接本地 MCP server（http://localhost:10620/mcp）。
通过 clawhub install hilight-video-generate 安装，clawhub hook 自动读取 clawhub.json 完成 mcporter 注册与 API Key 配置。
MCP 可用工具
通过 mcporter 连接的 hilight-video-generate MCP server 提供以下工具（tool）：
具体工具名和参数以 MCP server 实际暴露为准。以下为典型接口模式。
1. 创建视频任务
- 工具:
create_video/generate_video - 参数:
title：视频标题description：视频描述 / 脚本文案image_url：商品封面图 URL（可选）style：视频风格（可选）duration：时长偏好（可选）
- 返回:
task_id、初始状态
2. 查询任务状态
- 工具:
get_task_status/query_task - 参数:
task_id：任务 ID
- 返回: 状态（pending / processing / completed / failed）、进度百分比、预计剩余时间
3. 下载 / 获取视频
- 工具:
get_video/download_video - 参数:
task_id：任务 ID
- 返回: 视频下载 URL、文件大小、时长
4. 列出历史任务
- 工具:
list_tasks - 参数:
page：页码（默认 1）page_size：每页数量（默认 20）status：按状态筛选（可选）
- 返回: 任务列表
执行流程
流程 A：生成新视频
用户："帮我生成一个 XX 产品的电商视频"
- 确认用户需求（标题、描述、风格）
- 通过 MCP 调用
create_video工具 - 拿到
task_id，告知用户任务已提交 - 自动查询一次状态
- 如果还在处理中，告知预计时间，后续用户可随时问进度
输出模板：
🎬 视频生成任务已提交！
- 任务 ID：task_abc123 ← 保存此 ID
- 标题：XX 产品营销视频
- 状态：processing（生成中）
- 预计完成：约 3-5 分钟
⏳ 稍后对我说"查一下视频进度"即可获取最新状态。
流程 B：查询进度
用户："查一下视频进度" / "task_abc123 好了吗"
- 通过 MCP 调用
get_task_status - 返回当前状态
输出模板（处理中）：
⏳ 任务 task_abc123 状态：processing
进度：68% ｜ 预计剩余：约 1 分钟
输出模板（已完成）：
✅ 视频已生成完成！
- 任务 ID：task_abc123
- 时长：00:30
- 文件大小：12.5 MB
- 下载链接：https://cdn.example.com/video/abc123.mp4
💡 说"下载这个视频"我帮你保存到本地。
流程 C：下载视频
用户："下载视频 task_abc123"
- 通过 MCP 获取下载 URL
- 使用
exec curl下载到本地
exec curl -L -o ~/Downloads/video_task_abc123.mp4 "VIDEO_DOWNLOAD_URL"
- 确认文件大小
exec ls -lh ~/Downloads/video_task_abc123.mp4
输出模板：
📥 视频已下载！
- 文件：~/Downloads/video_task_abc123.mp4
- 大小：12.5 MB
💡 可以直接用 QuickTime 播放，或拖到剪辑软件中使用。
错误处理
| 错误码 | 含义 | 处理方式 |
|---|---|---|
| 401/403 | API Key 无效或过期 | 提示用户检查 .env 文件中的 VIDEO_API_KEY |
| 404 | 任务不存在 | 提示检查 task_id 是否正确 |
| 429 | 请求频率限制 | 等待后重试，提示用户稍候 |
| 500+ | 服务端错误 | 告知用户服务暂时不可用，建议稍后重试 |
| MCP 连接失败 | mcporter 未启动或配置错误 | 提示检查 mcporter 状态和 mcporter.json 配置 |
API Key 管理
- 存储位置:
~/.openclaw/workspace/skills/hilight-video-generate/.env - 文件权限: 600（仅当前用户可读写）
- 更新方式: 直接编辑
.env文件 - 安全保证:
.env不会被提交到版本控制（gitignore 排除）