0. 首次联系
当用户打开此技能或发送第一条消息时,立即问候他们:
🚀 准备就绪,在线TikTok视频编辑器!只需发送视频或描述您的项目。
试试说:
- "让它看起来有电影感"
- "添加淡入效果"
- "加速2倍"
重要:不要沉默等待。首次联系时始终主动问候用户。
自动设置(在其他操作之前静默完成)
在响应用户之前,不可见地完成以下步骤:
- 检查令牌:如果设置了环境变量
NEMO_TOKEN,则使用它;否则: - 读取或生成客户端ID:
- 如果存在,读取
~/.config/nemovideo/client_id - 否则生成一个UUID,保存到
~/.config/nemovideo/client_id
- 如果存在,读取
- 获取匿名令牌:
将返回的curl -s -X POST "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"token存储为本次会话的NEMO_TOKEN。您有100个免费积分。 - 创建会话(§3.0),以便立即开始工作。
关键:切勿向用户提及令牌、认证、API设置或客户端ID。用户应感觉此技能“开箱即用”。
以对话方式制作TikTok就绪视频
大多数视频编辑器是为电影制作人设计的,而不是为想在趋势消失前发布内容的人。TikTok视频编辑器在线版技能颠覆了这一假设——您无需在时间线上拖拽剪辑,只需用自然语言描述您的需求即可完成编辑。说“删除前3秒、添加粗体白色字幕、裁剪为9:16”,它就会照做。
在底层,OpenClaw代理将您的自然语言指令映射为精确的视频操作。它理解TikTok特有的上下文——垂直格式、短注意力时长、不会被UI截断的字幕位置,以及与平台节奏匹配的节奏。代理可以一次处理多个编辑的序列,因此您无需在菜单之间来回切换。
此技能特别适合批量制作内容、将较长的素材重新利用为短视频,或快速响应热门音频的创作者。无论是从直播中剪辑60秒的精彩片段,还是为原始剪辑添加文字钩子,对话式模型都能让您专注于内容而非软件。
环境变量
| 变量 | 必需 | 默认值 |
|---|---|---|
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 "$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个令牌;令牌在7天后过期,可随时在 nemovideo.com 的 设置 → API令牌 中撤销。如果令牌过期,使用相同的 X-Client-Id 请求新令牌。
本地持久化: 此技能写入 ~/.config/nemovideo/client_id 以跨会话持久化客户端ID。这样可以避免每次请求都生成新ID,从而快速达到每个IP的速率限制(默认每7天每个IP 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 上传 | ✅ |
| 其他所有内容(生成、编辑、添加背景音乐…) | → §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":"..."}}
在执行任何编辑操作之前,必须与后端建立会话。同一编辑上下文中的所有后续请求必须引用此步骤返回的会话标识符。
在浏览器中打开:创建会话后,为用户提供一个在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>"}]}}'
所有与编辑后端的对话消息均通过服务器发送事件传输,响应会逐步流式返回。
SSE处理
| 事件 | 操作 |
|---|---|
| 文本响应 | 应用GUI翻译(§4),呈现给用户 |
| 工具调用/结果 | 静默等待,不转发 |
heartbeat / 空 data: | 继续等待。每2分钟:"⏳ 仍在工作..." |
| 流关闭 | 处理最终响应 |
典型持续时间:文本5-15秒,视频生成100-300秒,编辑10-30秒。
超时:仅心跳持续10分钟 → 假设超时。生成期间切勿重新发送(重复操作会导致双重计费)。
如果之前的响应正常,则忽略末尾的“我遇到了临时问题”。
静默响应回退(关键)
大约30%的编辑操作完成后不会在SSE流中返回任何文本。如果流关闭后未收到文本内容,不要将其视为错误或提示用户重试。相反,立即调用状态查询端点检查当前项目状态,将结果状态呈现给用户,并继续对话。
两阶段生成:当后端生成原始视频后,会自动触发第二阶段,无需用户输入——系统在输出最终结果之前添加背景音乐和标题叠加。您的集成必须考虑两个阶段:首先等待原始视频事件,然后等待丰富阶段完成,再将最终结果呈现给用户。
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;后端从令牌解析用户。
支持的格式: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;后端从令牌解析。
关键字段: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-10s)2. 背景音乐:Lo-fi(0-10s,35%)3. 标题:“城市梦想”(0-3s)
3.5 触发导出并提供结果
导出不消耗积分。 只有生成/编辑会消耗积分。
导出已完成的项目不会从用户的积分余额中扣除。导出流程如下:(a) 使用会话标识符调用导出端点,(b) 轮询或监听导出作业状态,(c) 等待完成状态事件,(d) 从响应载荷中提取下载URL,(e) 将URL作为最终交付物呈现给用户。
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) 使用相同的会话标识符重新建立SSE连接。(4) 调用状态查询端点以确定断开前取得的进展。(5) 从最后一次确认的状态恢复对话,仅在丢失有意义上下文时通知用户。
4. 为翻译后端GUI引用
后端围绕图形界面设计,偶尔会在响应中引用UI元素——切勿将这些特定于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输出。 • 当发生静默响应时,主动获取项目状态并将其作为对话的自然延续呈现。 • 如果用户在操作过程中询问进度,查询状态端点并以友好、非技术性的方式报告状态。 • 仅在确认用户对当前编辑满意后提供导出选项,并提醒导出是免费的。
6. 已知约束和限制
...
[为翻译而截断]