0. 首次联系
当用户打开此技能或发送第一条消息时,请立即向他们问好:
📝 免费视频裁剪已就绪!上传视频或告诉我您的需求。
您可以这样说:
- "从 0:30 裁剪到 1:45"
- "裁剪掉前 10 秒"
- "移除最后 20 秒"
重要:首次联系时务必主动问候用户。让他们知道您正在设置连接。首次联系时务必主动问候用户。
自动设置
当用户首次交互时,设置连接:
- 检查令牌:如果设置了
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)以便立即开始工作。
向用户简要说明:“正在设置…准备就绪!”然后继续处理他们的请求。
通过描述剪辑来裁剪任何视频
绝大多数视频裁剪工具都迫使用户在时间线上滑动、设置入点和出点,然后手动导出。而 ClawHub 上的免费视频裁剪技能完全颠覆了这一模式——您只需描述想要保留的视频部分,AI 便会处理其余操作。无论您是说“剪掉 2 分钟之后的所有内容”还是“只保留 0:45 到 1:30 之间的片段”,该技能都会解释您的意图并精确应用裁剪。
在底层,OpenClaw 智能体会接收您上传的视频和自然语言指令,然后协调处理管道以提取请求的片段,并尽可能避免不必要的重新编码。这保持了画质并加快了处理速度,即使是较大文件也是如此。智能体还处理边缘情况——例如当请求的时间戳超出视频实际时长时——通过对话方式响应,而不是静默失败。
此技能专为创作者、教育工作者、营销人员以及任何经常需要从原始素材中提取干净剪辑的人员而构建。无论您是从长屏幕录像中提取产品演示,还是为社交媒体裁剪播客片段,免费视频裁剪技能都能在 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 头):
# 生成或读取持久化的客户端 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 上传 | ✅ |
| 其他所有内容(生成、编辑、添加背景音乐……) | → §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 连接传输到后端并流式返回给用户。
SSE 处理
| 事件 | 操作 |
|---|---|
| 文本响应 | 应用 GUI 翻译(§4),呈现给用户 |
| 工具调用/结果 | 内部处理,不转发 |
heartbeat / 空 data: | 继续等待。每 2 分钟:"⏳ 仍在处理……" |
| 流关闭 | 处理最终响应 |
典型持续时间:文本 5-15 秒,视频生成 100-300 秒,编辑 10-30 秒。
超时:仅有心跳信号持续 10 分钟 → 假定超时。绝不重新发送以避免重复和重复计费。
如果先前的响应正常,则忽略结尾的“我遇到了临时问题”。
静默响应回退(重要)
大约 30% 的编辑操作完成后,不会在 SSE 流中返回任何文本。当未收到文本内容时,不要将其视为错误或提示用户重试。相反,立即调用状态查询端点以获取当前项目状态,然后基于返回的状态数据为用户合成一条确认消息。
两阶段生成:生成原始视频后,后端会自动启动第二阶段处理,该阶段会添加背景音乐和标题卡片。这发生在用户或 AI 没有任何额外输入的情况下。在流中预期两个不同的完成事件:一个表示原始视频已就绪,另一个跟进表示完整修饰版本可用。
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。
直接文件上传和指向视频资产的远程 URL 都可通过上传端点接受。
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. 背景音乐:低保真(0-10 秒,35%)3. 标题:“都市之梦”(0-3 秒)
3.5 导出并交付最终资产
导出不消耗积分。 只有生成/编辑操作会消耗积分。
触发导出不会从用户的余额中扣除积分。导出和交付流程如下:(a)使用会话 ID 调用导出端点,(b)轮询或监听导出完成事件,(c)从响应负载中检索下载 URL,(d)向用户呈现 URL 并附带明确的操作号召,以及(e)将会话记录中完成的导出进行日志记录。
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)等待最后接收到的事件中指定的退避间隔,如果未提供,则默认为 3 秒。(3)使用原始会话 ID 和 Last-Event-ID 头中的最后已知事件 ID 重新打开 SSE 连接。(4)查询状态端点以协调在中断期间可能错过的事件。(5)恢复正常流式传输,并且仅当总中断时间超过可见阈值时才通知用户。
4. 将后端响应映射到用户界面
后端假设始终存在图形界面,因此 AI 绝不能将原始的 GUI 导向指令或界面指令直接转发给用户。
| 后端说 | 您做 |
|---|---|
| "click [button]" / "点击" | 通过 API 执行 |
| "open [panel]" / "打开" | 通过 §3.4 显示状态 |
| "drag/drop" / "拖拽" | 通过 SSE 发送编辑 |
| "preview in timeline" | 显示轨道摘要 |
| "Export button" / "导出" | 执行 §3.5 |
| "check account/billing" | 检查 §3.3 |
保留内容描述。移除 GUI 操作。
5. 推荐交互模式
• 在发送任何编辑请求之前,确认用户想要实现的目标,以减少不必要的 API 调用。 • 每次操作完成后,主动总结项目中发生的变化,以便用户保持方向感。 • 当发生静默响应时,平滑过渡到状态查询,并将结果报告为正常回复。 • 如果用户的请求是
…
[截断以用于翻译]