by 安全扫描
OpenClaw
安全
medium confidence该技能的代码、指令和所需凭证（DOUBAO_API_KEY）与Volcengine/Seedance视频/图像生成工具一致；少量元数据和依赖注释不一致，但这并不表明存在误导。
评估建议
This package 应用ears to be what it says: a Next Video Gen integration for Volcengine Ark/种子ance that uses a single API key (DOUBAO_API_KEY) and Node. Before 安装ing, consider:
- 验证 the DOUBAO_API_KEY you provide has only the minimal 权限s needed (创建 a key scoped to the necessary 模型s if possible).
- The 安装er will write files into your OpenClaw 技能s directory (it attempts to 检测 common locations or will 创建 ~/.OpenClaw/技能s). If you prefer, 运行 the 安装er interactively and choose a safe 安装 path.
- 生成d as设置s a...详细分析 ▾
ℹ 用途与能力
The 技能's name/description (Next Video Gen via Volcengine Ark / 种子ance) matches the included scripts which call Ark API 端点s. 技能.md and the scripts require Node and DOUBAO_API_KEY (expected). There is a registry-summary mismatch (top-level 'Requirements' 报告ed none) — the 技能.md metadata correctly declares 'node' and DOUBAO_API_KEY. This 应用ears to be a metadata/packaging inconsistency rather than malicious misalignment.
✓ 指令范围
运行time instructions and scripts only: (1) 检查 for an API key, (2) submit generation 请求s to Volcengine Ark 端点s, (3) poll for 结果s, (4) 下载 生成d as设置s to a local 输出 directory. The 安装er and scripts inspect standard 系统 paths (home dir, possible OpenClaw 命令行工具) and write files into the user's 技能s directory and ~/Videos/next-video-gen by default — all consistent with the 状态d purpose. The code does 下载 content from user-supplied URLs (images/videos/audio) and writes files locally, which is required for its functionality but worth noting.
ℹ 安装机制
There is no registry '安装' section (instruction-only), but package includes a local 安装er (bin/命令行工具.js) that copies bundled files into the 代理's 技能s directory. The 安装er does not fetch arbitrary remote code during 安装. It 检查s for curl/jq and suggests 安装ing them, though the 仓库 provides Node-based replacements; this is a mild inconsistency but not high-risk (no external 下载 URLs or URL-shorteners are used by the 安装 script).
ℹ 凭证需求
The only 运行time secret required is DOUBAO_API_KEY (primaryEnv), which is 应用ropriate for calling Volcengine Ark APIs. The top-level registry summary incorrectly 列出ed no required env vars; 技能.md and scripts do require DOUBAO_API_KEY. No unrelated 凭证s or broad file系统/config paths are 请求ed.
✓ 持久化与权限
The 技能 is not always-enabled and does not 请求 elevated or cross-技能 configuration changes. It writes files to its own 技能s folder and 创建s an 输出 directory under the user's home — expected behavior for a local 技能 and 安装er.
⚠ bin/cli.js:69
Shell command execution 检测ed (child_process).
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.22026/4/26
- 添加了Node.js脚本使用说明以支持跨平台（run-gen.js）。 -澄清了视频/音频选项（`--no-audio`现在默认为“否”，使用`--no-audio false`启用音频）。 - Bash脚本现在被记录为“遗留，兼容”。 - 为Windows HTTPS问题记录了新的错误代码，并建议重试。 - 对输出中的示例和默认规格的呈现进行了小幅度改进。
● 无害
安装命令
点击复制官方npx clawhub@latest install next-video-gen
镜像加速npx clawhub@latest install next-video-gen --registry https://cn.longxiaskill.com 镜像可用
技能文档
模型
| 模型 ID | 能力 | API 端点 | |---------|------|----------| |doubao-seedream-5-0-260128 | 文生图 | POST /v3/images/generations |
| doubao-seedance-1-5-pro-251215 | 文生视频、图生视频、素材生视频（1.5 Pro） | POST /v3/contents/generations/tasks |
| doubao-seedance-2-0-260128 | 文生视频、图生视频、素材生视频（2.0） | POST /v3/contents/generations/tasks |
默认模型：doubao-seedance-1-5-pro-251215
生成模式
| 模式 | 说明 | 必需参数 | |------|------|---------| |txt2img | 文生图 | prompt |
| txt2video | 文生视频（默认无音频） | prompt, duration |
| img2video | 图生视频 | prompt, image URL, duration |
| vid2video | 素材生视频 | prompt, video URL, duration |
参数说明
图片参数（txt2img）
| 参数 | 默认值 | 可选值 | 说明 | |------|--------|--------|------| |--quality | 2K | 2K, 1K, HD | 分辨率。2K ≈ 2048px |
| --aspect-ratio | 1:1 | 1:1, 16:9, 9:16 | 宽高比 |
| --watermark | true | true, false | 是否显示水印 |
视频参数（txt2video / img2video / vid2video）
| 参数 | 默认值 | 可选值 | 说明 | |------|--------|--------|------| |--duration | 5 | 4–12 | 时长（秒） |
| --quality | 720p | 480p, 720p, 1080p | 分辨率 |
| --aspect-ratio | 16:9 | 16:9, 9:16, 1:1 | 宽高比 |
| --watermark | true | true, false | 是否显示水印 |
| --no-audio | 默认无音频 | — | 启用音频（--no-audio false） |
| --model | doubao-seedance-1-5-pro-251215 | 见模型表 | 指定模型 |
参考素材
| 参数 | 说明 | |------|------| |--image | 参考图片（图生视频），可多次使用多张 |
| --video | 视频素材（素材生视频） |
| --audio | 参考音频（作为背景音乐） |
用法
Node.js 脚本（推荐，跨平台）
# 设置 API key
export DOUBAO_API_KEY=your_key_here
# 文生图
node scripts/run-gen.js "一只橘猫在阳光下打盹" --mode txt2img
# 文生图（指定分辨率和比例）
node scripts/run-gen.js "未来城市夜景" --mode txt2img --quality 2K --aspect-ratio 16:9
# 文生视频（默认无音频）
node scripts/run-gen.js "海上日落延时摄影" --mode txt2video
# 文生视频（带音频）
node scripts/run-gen.js "海上日落延时摄影，海浪轻拍" --mode txt2video --no-audio false
# 图生视频
node scripts/run-gen.js "镜头缓慢推进，猫咪转身" --mode img2video --image "https://example.com/cat.jpg"
# 多张参考图生视频
node scripts/run-gen.js "从第一张平滑过渡到第二张" --mode img2video --image "https://example.com/1.jpg" --image "https://example.com/2.jpg"
# 素材生视频
node scripts/run-gen.js "镜头加快，色彩更鲜艳" --mode vid2video --video "https://example.com/input.mp4"
# 素材生视频 + 参考音频
node scripts/run-gen.js "节奏加快，配欢快背景音乐" --mode vid2video --video "https://example.com/input.mp4" --audio "https://example.com/bgm.mp3"
# 指定模型（2.0）
node scripts/run-gen.js "无人机航拍山谷" --mode txt2video --model doubao-seedance-2-0-260128 --duration 8 --quality 1080p
# 竖屏视频
node scripts/run-gen.js "瀑布流淌" --mode txt2video --aspect-ratio 9:16
# 关闭水印
node scripts/run-gen.js "抽象艺术动画" --mode txt2video --watermark false
Bash 脚本（旧版，兼容）
./scripts/seedance-gen.sh "小猫在草地上奔跑" --mode txt2video
~/Videos/next-video-gen/（可通过环境变量 NEXT_VIDEO_GEN_OUTPUT_DIR 配置）
脚本输出协议
解析以下结构化行并处理： | 行格式 | 何时出现 | 操作 | |--------|---------|------| |TASK_SUBMITTED: task_id= mode=<模式> | 提交后 | 告诉用户任务已开始 |
| STATUS_UPDATE: | 每 30 秒 | 告诉用户进度 |
| IMAGE_URL= | 图片成功 | 展示 URL |
| VIDEO_URL= | 视频成功 | 展示 URL |
| ELAPSED= | 成功时 | 可提及耗时 |
| DURATION= | 视频成功 | 展示时长 |
| ASPECT_RATIO= | 成功时 | 展示比例 |
| RESOLUTION= | 成功时 | 展示分辨率 |
| HAS_AUDIO= | 视频成功 | true 时告知"含音频" |
| LOCAL_FILE= | 成功时 | 告知本地保存路径 |
| ERROR: ... | 失败时 | 展示错误信息 |
交付标准
生成成功后，完整呈现： ① 本地文件 — 告知保存路径 ② 规格 — 分辨率、宽高比、时长、是否含音频 ③ 在线链接 — 注明"24 小时内有效" ④ 耗时 — 可选 示例（视频）： ``
视频生成完成！
本地文件：~/Videos/next-video-gen/video_20240412_153012.mp4
规格：5秒 · 720p · 16:9 · 无音频
在线链接（24小时有效）：https://cdn.example.com/video.mp4
生成用时：47秒
`
示例（图片）：
`
图片生成完成！
本地文件：~/Videos/next-video-gen/img_20240412_153012.png
规格：2K · 1:1
在线链接（24小时有效）：https://cdn.example.com/image.png
生成用时：8秒
`
错误处理
| 错误码 | 说明 | 用户操作 |
|--------|------|---------|
| 401 | API Key 无效 | 去控制台检查密钥 |
| 403 | 权限不足 | 检查密钥的模型权限 |
| 429 | 请求过频 | 稍后重试 |
| 500-503 | 服务异常 | 稍后重试 |
| HTTP_ERROR:Client network socket disconnected | Windows 环境 HTTPS 问题 | 重试，通常第二次成功 |
安装后
技能首次加载时检查 DOUBAO_API_KEY`：
- 已设置： "准备好了！你想生成什么？"
- 未设置： "需要配置豆包 API 密钥才能使用。去火山引擎控制台获取一下吗？" 并引导配置。
核心原则
- 引导而非替用户决定 — 提供选项，让用户自己选
- 用户驱动创意 — 用用户的描述，需要时提供建议
- 智能上下文感知 — 只询问缺失部分
- 意图优先 — 意图不明确时先确认
参考
- 文生图模型：https://console.volcengine.com/ark/model_detail?Id=doubao-seedream-5-0-260128
- 视频 1.5 Pro：https://console.volcengine.com/ark/model_detail?Id=doubao-seedance-1-5-pro-251215
- 视频 2.0：https://console.volcengine.com/ark/model_detail?Id=doubao-seedance-2-0-260128