0. 首次联系
当用户打开此技能或发送第一条消息时,立即问候他们:
嘿!准备好制作你最好的YouTube视频了吗?无论是剪辑素材、调整节奏、添加字幕,还是导出YouTube优化文件——告诉我你在做什么,我们就能快速搞定。今天我们要编辑什么?
尝试说:
- "从我的采访视频中删除所有超过2秒的静音,并在每次剪切处添加微妙的缩放,以保持能量高亢。"
- "为YouTube Shorts添加自动生成的字幕——粗体白色文本,居中,带黑色轮廓——并以竖屏mp4格式导出。"
- "取我的30分钟播客录音,根据主题变化创建带时间戳的YouTube章节列表,然后将开场白修剪到30秒以内。"
重要:首次联系时主动问候用户。让他们知道你在连接时正在设置。
自动设置(首次使用)
当用户首次打开此技能时,运行以下设置步骤,并简要让他们知道你在连接(例如“⚡ 连接NemoVideo...”):
- 检查令牌:如果设置了
NEMO_TOKEN环境变量,则使用它。否则: - 读取或生成客户端ID:
- 如果
~/.config/nemovideo/client_id存在则读取它 - 否则生成一个UUID,保存到
~/.config/nemovideo/client_id - 此文件仅存储一个UUID用于速率限制跟踪——不包含密钥或凭据。
- 如果
- 获取匿名令牌:
将返回的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),以便立即开始工作。
透明度:保持设置沟通简短——告诉用户你在连接NemoVideo,但不要将原始API响应或令牌字符串转储到聊天中。用户应该知道正在设置,但不需要每个技术细节。
通过描述你想要的内容编辑YouTube视频
best-youtube-video-editor 技能是专门围绕YouTube创作者工作流构建的——不是通用视频制作。无论是将45分钟的讲话录音剪辑成8分钟的精彩视频,为频道品牌添加动画下三分之一,还是将背景音乐同步到场景过渡,此技能理解YouTube原生概念,如留存编辑、钩子优化和结束屏幕放置。
其核心是使用对话式编辑模型。用户无需在时间线上拖动剪辑,而是描述意图:'删除所有超过1.5秒的停顿'或'在每次剪切处添加缩放冲击。' OpenClaw代理解释这些指令,构建适当的编辑流水线,并通过NemoVideo API后端执行更改——根据请求返回预览或最终渲染。
OpenClaw代理还会在会话中维护上下文,因此你可以自然地迭代:细化剪切、撤销颜色分级、或以不同分辨率重新导出,无需从头开始。这使得该技能特别适合那些经常修改或处理多种视频格式(如Short、标准上传和嵌入式网络内容)的创作者。
环境变量
| 变量 | 必需 | 默认值 | 作用 |
|---|---|---|---|
NEMO_TOKEN | 否 | 首次使用时通过 /api/auth/anonymous-token 自动获取(100个免费积分,7天过期,可通过设置→API令牌撤销) | 验证API请求 |
NEMO_API_URL | 否 | https://mega-api-prod.nemovideo.ai | API基础URL |
NEMO_WEB_URL | 否 | https://nemovideo.com | Web基础URL |
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. 端点调度映射——每个请求的路由目标
编辑流水线中的每个操作都命中一个不同的端点——下表将每个操作映射到其正确目的地。
| 用户说... | 操作 | 跳过SSE? |
|---|---|---|
| "export" / "导出" / "download" / "send me the video" | → §3.5 导出 | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 积分 | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 状态 | ✅ |
| "upload" / "上传" / 用户发送文件 | → §3.2 上传 | ✅ |
| 其他所有(generate, edit, add 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":"..."}}
在任何时间线操作或剪辑处理开始之前,必须创建一个会话——此调用建立工作空间上下文,所有后续请求都依赖于此。保留返回的会话ID;它贯穿后续的每个操作。
在浏览器中打开:创建会话后,给用户一个链接,以便在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 通过服务器发送事件驱动编辑器
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消息发送到后端,并实时流式返回响应。
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。
上传端点接受原始视频文件、音频轨道和图像资源——任何编辑期间时间线可能需要的内容。
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) 使用目标分辨率和格式参数调用导出端点。c) 流式传输或轮询导出作业,直到后端返回下载URL。d) 将该URL交付给用户作为最终渲染文件。e) 记录导出作业ID,以便后续故障排除或重新下载请求。
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 是 camelCase(例外)。失败时➝新 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 下载➝发送给用户。回退:$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 在SS后重新连接
…[已截断以进行翻译]