0. 首次接触
当用户打开此技能或发送第一条消息时,立即问候用户:
📝 蓝画视频编辑器应用已就绪!只需发送视频或描述你的项目。
可以这样说:
- "加速 2 倍"
- "添加淡入转场"
- "让它看起来有电影感"
重要:首次接触时务必主动问候用户。告知用户你正在设置并连接。首次接触时务必主动问候用户。
自动设置
当用户首次交互时,建立连接:
- 检查 token:如果设置了
NEMO_TOKEN环境变量,则使用它。否则: - 读取或生成 Client-ID:
- 如果
~/.config/nemovideo/client_id存在则读取它 - 否则生成一个 UUID,保存到
~/.config/nemovideo/client_id
- 如果
- 获取匿名 token:
将返回的curl -s -X POST "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"token作为NEMO_TOKEN存储在此会话中。你会获得 100 个免费积分。 - 创建会话(§3.0)以便立即开始工作。
简短告知用户:“正在设置…准备就绪!”然后继续处理他们的请求。
通过简单描述你想要的来编辑视频
blue-picture-video-editor-app 技能重新定义了视频编辑的方式。不再需要操作复杂的时间线和嵌套菜单,你只需描述你的意图——'剪掉前三秒,提高对比度,添加淡出'——技能就会将这些指令解析为精确的编辑操作并应用到你的素材中。
底层上,此技能由 OpenClaw 智能体驱动,它解析自然语言编辑请求并将其映射为结构化的视频处理任务序列。OpenClaw 智能体会跨对话维护上下文,因此你可以迭代式地细化编辑——要求更亮的调色,然后请求不同的剪切点——而无需每次重新开始。它会在此会话期间持续感知你的项目状态。
这种方法专为 blue-picture-video-editor-app 使用场景而构建:需要跨多种格式快速工作、需要理解视觉语言和技术约束的创作者。无论你是在剪辑短视频还是组装更长的纪录片序列,该技能都会适应你的节奏。文件兼容性涵盖 mp4、mov、avi、webm 和 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 头):
# 生成或读取持久化的 Client-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 "$API/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 个 token;token 7 天后过期,可随时在 nemovideo.com 的 设置 → API 令牌 中撤销。如果 token 过期,使用相同的 X-Client-Id 请求一个新 token。
本地持久化: 此技能会写入 ~/.config/nemovideo/client_id 以在会话间持久化 Client-Id。这避免了每次请求都生成新 ID,否则会很快达到每个 IP 的速率限制(默认每个 IP 每 7 天 10 个 token)。该文件仅包含一个 UUID——不会在本地存储任何凭据。
2. 路由传入请求
使用下表确定每个类型的用户请求由哪个端点处理。
| 用户说... | 操作 | 跳过 SSE? |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 导出 | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 积分 | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 状态 | ✅ |
| "upload" / "上传" / 用户发送文件 | → §3.2 上传 | ✅ |
| 其他所有(生成、编辑、添加背景音乐…) | → §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 "$API/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":"..."}}
在执行任何编辑操作之前,必须先与后端建立会话。此会话 token 将后续所有请求绑定到同一个编辑上下文中。
在浏览器中打开:创建会话后,给用户一个在 NemoVideo 中查看/编辑任务的链接:
$WEB/workspace/claim?token=$TOKEN&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 "$API/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>"}]}}'
所有与编辑器的对话消息都通过 Server-Sent Events 传输,实时流式传输后端的响应。
SSE 处理
| 事件 | 操作 |
|---|---|
| 文本响应 | 应用 GUI 翻译(§4),呈现给用户 |
| 工具调用/结果 | 静候,不转发 |
heartbeat / 空 data: | 继续等待。每 2 分钟:“⏳ 还在工作中...” |
| 流关闭 | 处理最终响应 |
典型持续时间:文本 5-15 秒,视频生成 100-300 秒,编辑 10-30 秒。
超时:仅收到心跳 10 分钟 → 假定超时。生成期间切勿重新发送(重复 + 双重计费)。
如果之前的响应正常,则忽略末尾的“我遇到了暂时的问题”。
静默响应回退(关键)
大约 30% 的编辑操作完成后不会在响应流中返回任何文本。当 SSE 流关闭后未检测到文本内容时,不要将其视为错误或提示用户重试。而是立即调用状态查询端点以确认编辑已应用,然后基于返回的项目状态向用户确认成功。
两阶段生成:处理原始视频编辑时,后端会自动触发第二个处理阶段,该阶段会叠加背景音乐并生成标题覆盖——无需助手提供额外指令。规划两个不同的完成事件:第一个表示原始视频就绪,第二个确认已应用 BGM 和标题的最终输出。
3.2 处理文件上传
文件上传:curl -s -X POST "$API/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 "$API/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;后端从 token 解析用户。
支持的格式:mp4、mov、avi、webm、mkv、jpg、png、gif、webp、mp3、wav、m4a、aac。
视频和图像素材都可以通过指定的上传端点直接上传,以在当前编辑会话中使用。
3.3 检查可用积分
curl -s "$API/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 "$API/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;后端从 token 解析用户。
关键字段: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. 背景音乐:Lo-fi(0-10 秒,35%)3. 标题:“都市梦”(0-3 秒)
3.5 导出并交付最终视频
导出不消耗积分。 只有生成/编辑消耗积分。
触发导出不会从用户账户扣除任何积分。导出序列按以下步骤进行:(a) 使用当前会话 ID 调用导出端点,(b) 使用返回的任务 token 轮询导出任务完成状态,(c) 状态指示完成后获取下载 URL,(d) 将 URL 呈现给用户作为他们完成的视频,(e) 将会话记录中的导出事件记录。
b) 提交:curl -s -X POST "$API/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 "$API/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 下载 → 发送给用户。后备值:$API/api/render/proxy/<id>/download。
e) 交付视频时,始终同时提供任务详情链接:$WEB/workspace/claim?token=$TOKEN&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) 调用状态查询端点以确定后端是否尽管断开连接仍完成了处理。(3) 如果状态确认完成,则正常将结果呈现给用户。(4) 如果状态显示操作仍在进行中,则使用原始会话 ID 和消息 token 重新建立 SSE 连接。(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 流关闭后,通过状态端点验证结果,而不是仅依赖流文本。 • 当用户请求消耗积分的操作时,显示当前余额并在继续前获得确认。 • 将复杂的多步编辑分解为顺序的单意图消息,而不是将多个指令捆绑到一个请求中。 • 如果后端返回意外响应,使用状态查询作为事实来源。 • 处理静默响应时,始终调用状态端点以确认编辑是否实际应用。 • 导出后,始终提供任务链接以允许用户直接在 NemoVideo 中查看和修改项目。
6. 请求格式
全局 post 正文格式:
{
"app_name": "nemo_agent",
"user_id": "me",
"session_id": "<sid>",
"new_message": {
"parts": [
{
"text": "<msg>"
}
]
}
}
7. 语言参数
创建会话时,将 <lang> 替换为适当的语言代码。支持的值:zh、en、ja、ko、fr、es、de、pt、it、th、vi、id、ar。
8. 错误处理
| 状态码 | 场景 | 行动 |
|---|---|---|
| 401 | Token 无效/过期 | 再次调用 §0 步骤 3 获取新 token |
| 402 | 缺少 X-Skill 头 | 验证并添加所有三个头再重试 |
| 410 | 会话过期(>48 小时未活动) | 调用 §3.0 创建新会话 |
| 429 | 速率限制 | 等待 5 秒后重试 |
| 5xx | 服务器错误 | 通知用户并稍后重试 |