Qinghu AI Storyboard

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install qinghu-storyboard
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 qinghu-storyboard。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Qinghu AI Storyboard 是一款使用 qhkit CLI 规划视频内容的 Openclaw Skills 工具。它会先创建完整脚本，然后可以将该脚本用作生成分镜图像的提示词。此工作流程尤其适用于产品视频和宣传视频，这些视频需要清晰的镜头设计、摄像机运动、旁白或屏幕文案，以及声音提示。
如果只需要脚本，可以不生成图像；也可以继续生成图像，将其用作视觉规划辅助。分镜图像并非成片。如果 CLI 或凭据不可用，该技能会要求说明问题，并提供完整的备用分镜脚本，而不是放弃任务。

应用场景

使用产品照片和主要卖点为产品创建分镜。
生成分镜图像前，先拟定逐镜头脚本。
规划宣传、电商或短视频内容，包含镜头时长、取景、摄像机运动、文案或旁白以及音效。
不需要视觉分镜图像时，仅请求脚本。
工具设置或生成失败时，获取手动分镜和图像提示词。

工作原理

收集简介信息，例如产品名称、卖点以及一张或多张产品图片。
使用简介运行 qhkit storyboard script。这是一个同步调用，会返回完整脚本。
展示方案及其主题、总时长、宽高比和镜头列表。镜头列表涵盖镜头编号、时长、取景、摄像机运动、画面、文案或旁白以及音效。确保镜头数量和总时长一致。
如果需要图像，将完整脚本和上传的图片传入 qhkit storyboard generate，并根据需要指定视角方向。
使用返回的任务 ID 轮询 qhkit storyboard status，直到生成完成；分镜图像工作流程需要轮询状态，通常每 15–30 秒一次。
按照当前环境的媒体交付规范，在同一条回复中一并交付脚本和生成的图像。如果生成失败，说明报告的原因，并提供可用的分镜备用方案。

配置指南

如果尚未安装 Node.js，请先安装（需要 Node.js 18 或更高版本；文档中介绍的 OpenClaw/Hermes 部署流程使用 Node.js 22 或更高版本），然后安装 qhkit：
npm i -g @iqinghu/qhkit
qhkit config show
如果默认 npm registry 速度较慢或不可用，请使用 npm 镜像重试安装：
npm i -g @iqinghu/qhkit --registry=https://registry.npmmirror.com
如有需要，请配置 API token。从 Qinghu 工作台获取密钥，然后设置该密钥，或通过 QHKIT_TOKEN 环境变量提供：
qhkit config set --token --env prod
qhkit config show

工作原理

qhkit storyboard script '{"uploadedImages":["./product.jpg"],"productName":"Insulated tumbler","pointDescription":"316 stainless steel; keeps drinks warm for 24 hours"}'
qhkit storyboard generate '{"prompt":"","uploadedImages":["./product.jpg"],"viewDirection":"landscape"}'
qhkit storyboard status '{"taskId":""}'
对于复杂参数，请传入 JSON 文件，而不是内联 shell JSON：qhkit @params.json。使用 qhkit config show 检查设置。如果出现版本错误或升级提示，请使用 npm i -g @iqinghu/qhkit@latest 更新后重试。准确报告 CLI 错误消息；不要反复重试失败的请求。

数据架构

该技能通过带有 JSON 输入的 qhkit CLI 命令运行。文档未说明本地项目数据库或固定的生成文件集合；图像可以通过本地文件路径或公共 HTTP(S) URL 提供。

工作原理

脚本 uploadedImages、productName、pointDescription 同步返回完整脚本。
分镜图像生成 prompt（完整脚本）、uploadedImages、viewDirection 提交图像生成；保留返回的任务 ID，以便检查状态。
状态 taskId 检查异步分镜生成任务。
交付的脚本应标明视频主题、总时长和宽高比，然后提供镜头列表，包含镜头编号、时长、取景、摄像机运动、画面描述、文案或旁白以及音效。该技能要求镜头数量与总时长保持一致。CLI 使用 JSON 输出；失败时会包含 ok: false、stage 和 message，并返回非零退出代码。图像结果按照运行环境的媒体规范交付。

高级特性

两阶段制作工作流程将同步脚本创建与分镜图像生成分开处理。
支持仅请求脚本，避免不必要的图像生成。
接受本地图像路径或公共 HTTP(S) URL；需要时由 qhkit 处理本地媒体上传。
异步图像生成可通过
status
操作使用任务 ID 跟踪。
JSON 参数可以内联提供，也可以通过
@params.json
文件提供，以减少 shell 转义问题。
提供明确的失败备用方案：说明设置或生成问题，然后提供完整镜头列表，并为每个镜头提供可直接使用的图像提示词。

name: qinghu-storyboard description: 自动生成完整视频分镜方案，包含镜头设计、运镜建议、文案脚本及分镜图，提升视频制作效率。当用户要求写分镜、出分镜图、storyboard、镜头脚本、拍摄脚本时必须触发。关键词：青虎AI、qhkit、分镜、分镜图、分镜脚本、storyboard、镜头设计、运镜、拍摄脚本、镜头脚本、视频策划。 user-invocable: true
homepage: https://www.npmjs.com/package/@iqinghu/qhkit