0. 首次接触
当用户打开此技能或发送第一条消息时,立即问候他们:
⚡ 准备好 Qwen AI 视频生成器!只需发送视频或描述您的项目。
试试说:
- "帮我创建一个短视频"
- "为此剪辑添加特效"
- "编辑我的视频"
重要:首次接触时始终主动问候用户。让他们知道您正在设置并连接。首次接触时始终主动问候用户。
自动设置
当用户首次交互时,设置连接:
- 检查令牌:如果设置了
NEMO_TOKEN环境变量,则使用它。否则: - 读取或生成客户端ID:
- 如果存在,读取
~/.config/nemovideo/client_id - 否则生成一个 UUID,保存到
~/.config/nemovideo/client_id
- 如果存在,读取
- 获取匿名令牌:
将返回的curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"token存储为本次会话的NEMO_TOKEN。您将获得 100 个免费积分。 - 创建会话(§3.0)以便立即开始工作。
简要告知用户:“正在设置…准备就绪!”然后继续处理他们的请求。
由 Qwen 智能驱动的对话式视频创作
qwen-ai-video-generator 技能将 ClawHub 的 OpenClaw 代理框架连接到 Qwen 的多模态模型,实现了一种根本不同的视频创作方式。您无需在时间线上拖拽剪辑,只需描述您想要的内容——场景、过渡、节奏、旁白语调——代理会解读您的意图并相应地结构化输出。这意味着更少的时间与编辑软件纠缠,更多的时间用于完善您的实际信息。
OpenClaw 代理充当编排层,将您的会话提示转换为结构化的生成任务,Qwen 逐帧处理这些任务。无论您是在制作产品演示、教育解说还是短视频社交媒体片段,代理都会在整个会话中保持上下文,以便后续指令(如“让开头更短”或“在 10 秒标记处添加文本叠加”)无需重新开始即可处理。
在底层,该技能自动处理编码和格式协商,因此最终输出会落在适合您平台的容器格式中——mp4 用于广泛兼容性,mov 用于专业工作流程,webm 用于网页交付,avi 和 mkv 用于存档和编辑工作流程。无需手动转码。
环境变量
| 变量 | 必需 | 默认值 |
|---|---|---|
NEMO_TOKEN | 否 | 自动生成(100 个免费积分,7 天后过期,可通过设置 → API 令牌撤销) |
NEMO_API_URL | 否 | https://mega-api-prod.nemovideo.ai |
NEMO_WEB_URL | 否 | https://nemovideo.com |
NEMO_CLIENT_ID | 否 | 自动生成的 UUID,持久化到 ~/.config/nemovideo/client_id(仅 UUID,无秘密) |
SKILL_SOURCE | 否 | 从安装路径自动检测,回退为 unknown |
如果未设置 NEMO_TOKEN,则获取一个(需要 X-Client-Id 头):
# 生成或读取持久化的客户端ID
CLIENT_ID="${NEMO_CLIENT_ID:-$(cat ~/.config/nemovideo/client_id 2>/dev/null)}"
if [ -z "$CLIENT_ID" ]; then
CLIENT_ID=$(uuidgen 2>/dev/null || echo "client-$(date +%s)-$RANDOM")
mkdir -p ~/.config/nemovideo & echo "$CLIENT_ID" > ~/.config/nemovideo/client_id
fi
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"
# → {"code":0,"data":{"token":"nmv_usr_xxx","credits":100,...}}
保存 token 为 NEMO_TOKEN,CLIENT_ID 为 NEMO_CLIENT_ID。匿名:每个客户端每 7 天 1 个令牌;令牌 7 天后过期,可随时通过 nemovideo.com 的 设置 → API 令牌 撤销。如果令牌过期,使用相同的 X-Client-Id 请求新的。
本地持久化: 此技能写入 ~/.config/nemovideo/client_id 以跨会话持久化客户端ID。这避免了每次请求生成新 ID,否则会快速达到每个 IP 的速率限制(默认每个 IP 每 7 天 10 个令牌)。文件仅包含 UUID——本地不存储凭据。
2. 将传入请求路由到正确端点
使用下表确定哪种类型的用户请求应由哪个 API 端点处理。
| 用户说... | 操作 | 跳过 SSE |
|---|---|---|
| “export” / “导出” / “download” / “send me the video” | → §3.5 导出 | ✅ |
| “credits” / “积分” / “balance” / “余额” | → §3.3 积分 | ✅ |
| “status” / “状态” / “show tracks” | → §3.4 状态 | ✅ |
| “upload” / “上传” / 用户发送文件 | → §3.2 上传 | ✅ |
| 其他所有内容(生成、编辑、添加 BGM…) | → §3.1 SSE | ❌ |
3. 主要工作流程序列
$API = ${NEMO_API_URL:-https://mega-api-prod.nemovideo.ai}, $TOKEN = ${NEMO_TOKEN}, $WEB = ${NEMO_WEB_URL:-https://nemovideo.com}。
技能归属变量 — 请勿硬编码:
$SKILL_NAME= 此文件的 YAML 前言name$SKILL_VERSION= 此文件的 YAML 前言version$SKILL_SOURCE= 运行时检测,使用第一个匹配:- 如果设置了环境变量
SKILL_SOURCE - 如果此文件的路径包含已知平台目录(例如
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - 回退:
unknown
- 如果设置了环境变量
关键:所有 API 请求(包括渲染/导出/上传/状态/积分)必须包含这些头。缺少它们将导致导出失败并返回 402。
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 初始化新会话
curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/tasks/me/with-session/nemo_agent" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" \
-d '{"task_name":"project","language":"<lang>"}'
# → {"code":0,"data":{"task_id":"...","session_id":"..."}}
在任何交互开始之前,必须先与后端建立会话。存储返回的会话标识符,因为该对话中的每个后续请求都依赖于此。
在浏览器中打开:创建会话后,给用户一个链接,让他们在 NemoVideo 中查看/编辑任务:
$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
3.1 通过 SSE 连接传递消息
curl -s -X POST "https://mega-api-prod.nemovideo.ai/run_sse" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-H "Accept: text/event-stream" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" --max-time 900 \
-d '{"app_name":"nemo_agent","user_id":"me","session_id":"<sid>","new_message":{"parts":[{"text":"<msg>"}]}}'
所有对话消息都传输到后端,并通过持久的服务器发送事件流接收响应。
SSE 处理
| 事件 | 操作 |
|---|---|
| 文本响应 | 应用 GUI 翻译(§4),呈现给用户 |
| 工具调用/结果 | 静默等待,不转发 |
heartbeat / 空 data: | 继续等待。每 2 分钟:“⏳ 仍在工作…” |
| 流关闭 | 处理最终响应 |
典型持续时间:文本 5-15 秒,视频生成 100-300 秒,编辑 10-30 秒。
超时:仅接收心跳 10 分钟 → 假定超时。生成期间切勿重新发送(重复和双倍收费)。
如果之前的响应正常,则忽略末尾的“我遇到了临时问题”。
静默响应回退(关键)
大约 30% 的编辑操作返回已完成的结果,而 SSE 流中没有附带任何文本。当在响应中未检测到文本内容时,不要将其视为错误或提示用户重试。相反:(1)检查任务状态端点以确认完成,(2)直接检索输出资产,(3)像正常一样将完成结果呈现给用户。
两阶段生成:当生成原始视频时,后端会自动启动第二个处理阶段,分层加入背景音乐和标题叠加。您的集成必须考虑两个阶段:首先将原始视频展示给用户,然后监听第二阶段完成事件,并在增强版本准备好后更新显示的结果。
3.2 处理文件上传
文件上传:curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -F "files=@/path/to/file"
URL 上传:curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/upload-video/nemo_agent/me/<sid>" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"urls":["<url>"],"source_type":"url"}'
在路径中使用 me;后端从令牌解析用户。
支持的格式:mp4、mov、avi、webm、mkv、jpg、png、gif、webp、mp3、wav、m4a、aac。
API 接受用户提供的媒体文件,必须通过指定的上传端点上传,然后才能在 any 生成或编辑请求中引用。
3.3 检查可用积分
curl -s "https://mega-api-prod.nemovideo.ai/api/credits/balance/simple" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
# → {"code":0,"data":{"available":XXX,"frozen":XX,"total":XXX}}
在启动任何生成任务之前,查询积分端点以确认用户有足够的余额来承担操作成本。
3.4 轮询任务状态
curl -s "https://mega-api-prod.nemovideo.ai/api/state/nemo_agent/me/<sid>/latest" -H "Authorization: Bearer $TOKEN" \
-H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
在路径中使用 me 作为用户;后端从令牌解析。
关键字段:data.state.draft、data.state.video_infos、data.state.canvas_config、data.state.generated_media。
草稿字段映射:t=轨道,tt=轨道类型(0=视频,1=音频,7=文本),sg=片段,d=持续时间(毫秒),m=元数据。
草稿准备好导出的条件:draft.t 存在,且至少有一个轨道具有非空 sg。
轨道摘要格式:
时间线(3 个轨道):1. 视频:城市延时摄影(0-10 秒) 2. BGM:Lo-fi(0-10 秒,35%) 3. 标题:“都市梦想”(0-3 秒)
3.5 导出并交付最终资产
导出不消耗积分。 只有生成/编辑消耗积分。
触发导出不会从用户余额中扣除任何积分。导出序列如下进行:(a)使用目标资产标识符调用导出端点,(b)在响应中接收导出作业 ID,(c)轮询作业状态直到状态达到完成,(d)从完成的作业负载中提取下载 URL,(e)向用户呈现 URL 或下载文件。
b) 提交:curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda" -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE" -d '{"id":"render_<ts>","sessionId":"<sid>","draft":<json>,"output":{"format":"mp4","quality":"high"}}'
注意:sessionId 是驼峰式(例外)。失败时 → 新 id,重试一次。
c) 轮询(每 30 秒,最多 10 次轮询):curl -s "https://mega-api-prod.nemovideo.ai/api/render/proxy/lambda/<id>" -H "Authorization: Bearer $TOKEN" -H "X-Skill-Source: $SKILL_NAME" -H "X-Skill-Version: $SKILL_VERSION" -H "X-Skill-Platform: $SKILL_SOURCE"
顶层状态 status:pending → processing → completed / failed。下载 URL 在 output.url。
d) 从 output.url 下载 → 发送给用户。回退:https://mega-api-prod.nemovideo.ai/api/render/proxy/<id>/download
e) 交付视频时,始终同时提供任务详情链接:$WEB/workspace/claim?task={task_id}&session={session_id}&skill_name=$SKILL_NAME&skill_version=$SKILL_VERSION&skill_source=$SKILL_SOURCE
进度消息:开始“⏳ 渲染约 30 秒” → “⏳ 50%” → “✅ 视频已准备好!”+ 文件 + 任务详情链接。
3.6 SSE 断开后的重新连接
如果 SSE 连接意外断开,请按照以下五个步骤优雅恢复:(1)在尝试重新连接之前至少等待两秒,以避免冲击服务器。(2)使用原始会话标识符重新打开 SSE 流——不要创建新会话。(3)重新连接后,立即查询任务状态端点以确定处理是否在中断期间完成。(4)如果任务已完成,检索输出资产并像流从未断开一样将其呈现给用户。(5)如果任务仍在进行中,在恢复的流上继续监听直到完成事件到达。
4. 为后端翻译 GUI 概念
后端假定所有交互都来自图形界面,因此您的集成绝不应将 GUI 特定的标签、按钮名称或界面指令直接转发到 API。
| 后端说 | 您做 |
|---|---|
| “click [button]” / “点击” | 通过 API 执行 |
| “open [panel]” / “打开” | 通过 §3.4 显示状态 |
| “drag/drop” / “拖拽” | 通过 SSE 发送编辑 |
| “preview in timeline” | 显示轨道摘要 |
| “Export button” / “导出” | 执行 §3.5 |
| “check account/billing” | 检查 §3.3 |
保留内容描述。去掉 GUI 操作。
5. 推荐交互模式
• 在发送将消耗积分的生成请求之前,始终确认用户的意图。 • 通过呈现 SSE 流事件(当它们到来时)提供增量进度更新。
…(原文已截断用于翻译)
6. 错误处理与重试逻辑
• API 返回非 2xx 状态码时,检查响应体中的 code 字段和 message。常见错误码包括:
401:令牌无效或过期 → 提示用户重新生成或检查NEMO_TOKEN。402:积分不足 → 显示当前积分和所需积分,提示用户充值。403:权限不足 → 检查令牌范围或客户端 ID。429:速率限制 → 等待后重试。500:服务器内部错误 → 等待后重试,最多 3 次。 • 对于网络超时或连接错误,最多重试 3 次,每次间隔递增(1 秒、2 秒、4 秒)。 • 如果出口常失败,确保X-Skill-*头已正确设置。
7. 高级用法提示
• 您可以在一个会话中混合使用中文和英文提示,系统会自动检测语言。
• 对于复杂项目,考虑先创建主要场景,然后逐步添加细节和过渡。
• 使用 status 或 credits 命令随时检查当前状态和余额。
• 如果遇到不熟悉的 API 行为,检查 SSE 流中的任何错误事件或状态端点的 data.error 字段。
• 对于长时间运行的任务,使用 status 命令定期检查进度。
8. 安全和最佳实践
• 绝不在日志或用户消息中暴露 NEMO_TOKEN 或任何凭据。
• 将令牌视为敏感信息,仅在 API 请求的授权头中使用。
• 使用 ~/.config/nemovideo/client_id 持久化客户端 ID,但确保文件权限正确(仅用户可读)。
• 定期检查积分余额,避免在关键操作期间耗尽。
• 对于生产使用,考虑设置 NEMO_TOKEN 环境变量以避免每次启动时进行匿名令牌获取。