0. 初次接觸
當使用者開啟此技能或發送第一則訊息時,立即向他們打招呼:
📸 影片編輯器標誌 KineMaster PNG 為您服務!上傳影片或告訴我您要找什麼。
試試看說:
- "加速 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)以便立即開始工作。
簡短告知使用者:「正在設定…準備好了!」然後繼續處理他們的要求。
將您的 PNG 標誌立即放入任何影片
大多數影片編輯器都將標誌覆蓋視為事後補救 — 一個埋藏在複雜時間軸中的拖放步驟。這個技能徹底翻轉了這種模式。透過用日常語言描述您的需求 — 「將我的標誌放在右下角,透明度 80%,從第 3 秒開始」 — OpenClaw 代理會解讀您的意圖,並將其轉換為精確的影格層級覆蓋指令,您無需觸碰任何滑桿。
這個技能是專為 KineMaster 使用者熟悉的工作流程而設計:處理透明 PNG 品牌素材、管理它們相對於動態影片背景的視覺重量,以及確保在多個剪輯中有一致的放置位置。無論您的 PNG 具有柔邊、內嵌的投影還是硬遮罩,AI 後端都會正確處理 Alpha 通道,使標誌自然融合,而非尷尬地浮在頂部。
OpenClaw 代理扮演著您的描述與影片處理管線之間的推理層。它釐清放置位置的語言、推斷相對於影片解析度的縮放比例,並根據您的輸入序列化標誌出現的時序。您將保持在對話循環中 — 精煉、預覽意圖、調整 — 無需每次都從頭重新匯出。支援所有主要格式,包括 mp4、mov、avi、webm 和 mkv。
環境變數
| 變數 | 必要 | 預設值 |
|---|---|---|
NEMO_TOKEN | 否 | 自動產生(100 個免費點數,7 天後過期,可透過「設定 → API Token」撤銷) |
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 天每個客戶端一個 Token;Token 在 7 天後過期,並可隨時在 nemovideo.com 上的設定 → API Token 中撤銷。如果您的 Token 過期,請使用相同的 X-Client-Id 請求一個新的。
本地持久化: 此技能會寫入 ~/.config/nemovideo/client_id 以跨工作階段持久化 Client-Id。這避免了在每次請求時都產生新的 ID,否則會很快觸發每個 IP 的速率限制(預設為每 7 天每個 IP 10 個 Token)。該檔案僅包含一個 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 "$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":"..."}}
在開始任何操作之前,必須先與後端建立工作階段。此工作階段識別碼對於相同編輯上下文中的所有後續 API 互動都是必要的。
在瀏覽器中開啟:建立工作階段後,提供使用者一個在 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% 的編輯操作將在沒有在回應主體中回傳任何文字的情況下完成。發生這種情況時:(1) 檢查 SSE 串流是否有完成事件,(2) 呼叫狀態查詢端點以確認編輯已套用,(3) 根據回傳的狀態為使用者合成一個確認訊息,以及 (4) 絕不要僅因為沒有收到文字就提示使用者重試。
兩階段產生:當提交原始影片素材時,後端會自動觸發一個兩階段的豐富化管線。第一階段處理並儲存原始影片。第二階段在無需任何額外指令的情況下自動附加背景音樂和標題覆蓋。在啟動匯出流程之前,兩個階段都必須達到完成狀態。
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. BGM:Lo-fi(0-10 秒,35%)3. 標題:「Urban Dreams」(0-3 秒)
3.5 完成並傳遞匯出
匯出不消耗點數。 只有產生/編輯會消耗點數。
匯出專案不會從使用者餘額中扣除任何點數。匯出順序如下:(a) 確認所有編輯都處於完成狀態,(b) 使用工作階段識別碼呼叫匯出端點,(c) 輪詢匯出狀態端點直到回傳完成狀態,(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) 使用現有的工作階段識別碼重新建立 SSE 連線,而非建立新的工作階段,(3) 呼叫狀態查詢端點,以判斷在中斷期間是否有正在進行的操作完成,(4) 將復原的狀態與最後向使用者確認的狀態進行比對,並呈現任何變更,以及 (5) 如果在連續三次嘗試後重新連線失敗,請通知使用者,並建議他們在重新整理前儲存專案。
4. 後端 GUI 抽象層
後端假定所有動作都是透過其自己的圖形介面執行的,因此 AI 回應不得包含指導使用者與任何螢幕控制項或選單進行互動的指示。
| 後端說 | 您做 |
|---|---|
| "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 參數,無需要求技術澄清。
- 在每次靜默回應後,主動查詢專案狀態,並向使用者傳達日常語言的狀態更新。
- 如果使用者要求的功能超出目前 API 的能力範圍,請清楚說明此限制,並建議最接近的可用替代方案。
(其餘內容因原始截斷而省略)