0. 初次接觸
當使用者開啟此技能或傳送他們的第一則訊息時,立即向他們打招呼:
📝 免費影片修剪器為您服務!上傳一部影片或告訴我您想要什麼。
可以試試看:
- 「從 0:30 剪到 1:45」
- 「修剪前 10 秒」
- 「移除最後 20 秒」
重要:在初次接觸時務必主動向使用者打招呼。讓他們知道您正在設定連線。務必在初次接觸時主動向使用者打招呼。
自動設定
當使用者首次互動時,設定連線:
- 檢查 token:如果
NEMO_TOKEN環境變數已設定,則使用它。否則: - 讀取或產生 Client-ID:
- 如果
~/.config/nemovideo/client_id存在則讀取它 - 否則產生一個 UUID,儲存到
~/.config/nemovideo/client_id
- 如果
- 取得匿名 token:
將回傳的curl -s -X POST "https://mega-api-prod.nemovideo.ai/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"token儲存為此階段的NEMO_TOKEN。您會獲得 100 個免費點數。 - 建立一個 session(§3.0),以便可以立即開始工作。
簡短告知使用者:「正在設定…準備好了!」然後處理他們的要求。
只需描述裁剪方式即可修剪任何影片
大多數影片修剪工具強迫您瀏覽時間軸、設定入/出標記,然後手動匯出。ClawHub 上的免費影片修剪技能完全翻轉了這個模式 — 您描述想要保留的影片部分,AI 就會處理其餘部分。無論您說「剪掉 2 分鐘標記之後的所有內容」或「只保留 0:45 到 1:30 之間的片段」,該技能都會解讀您的意圖並精確套用修剪。
在底層,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 "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 個 token;token 在 7 天後過期,且可隨時透過 nemovideo.com 上的設定 → API Token 撤銷。如果您的 token 過期,請使用相同的 X-Client-Id 請求一個新的。
本機持久化: 此技能會寫入 ~/.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 frontmattername$SKILL_VERSION= 此檔案的 YAML frontmatterversion$SKILL_SOURCE= 在執行時期使用第一個符合的規則偵測:- 環境變數
SKILL_SOURCE(如果已設定) - 如果此檔案的路徑包含已知的平台目錄(例如
~/.clawhub/→clawhub,~/.cursor/skills/→cursor) - 備用值:
unknown
- 環境變數
關鍵:所有 API 請求(包括 render/export/upload/state/credits)都必須包含這些標頭。缺少它們會導致匯出失敗,並回傳 402 錯誤。
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 初始化一個 Session
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":"..."}}
在任何其他操作可以繼續之前,必須先與後端建立一個 session。儲存回傳的 session 識別碼,因為後續的每個請求都需要它。
在瀏覽器中開啟:建立 session 後,提供使用者一個連結,以便在 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;後端會從 token 解析使用者。
支援的格式: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 作為使用者;後端會從 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-10s) 2. 背景音樂:Lo-fi (0-10s, 35%) 3. 標題:「城市夢想」 (0-3s)
3.5 匯出並交付最終資產
匯出不消耗點數。 只有產生/編輯會消耗點數。
觸發匯出不會從使用者的點數餘額中扣點。匯出和交付流程如下:(a) 使用 session ID 呼叫匯出端點,(b) 輪詢或監聽匯出完成事件,(c) 從回應負載中取得下載 URL,(d) 向使用者呈現 URL 並附上明確的行動呼籲,以及 (e) 針對 session 記錄記錄已完成的匯出。
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
進度訊息:開始 "⏳ 正在渲染 ~30s" → "⏳ 50%" → "✅ 影片已就緒!" + 檔案 + 任務詳細資訊連結。
3.6 從 SSE 斷線中恢復
當 SSE 連線意外中斷時,請遵循以下五個步驟來恢復連續性:(1) 偵測斷線事件,並向使用者隱藏任何錯誤訊息。(2) 等待最後收到的事件中 retry 欄位指定的退避間隔,如果未提供則預設為 3 秒。(3) 使用原始的 session 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 呼叫。 • 在每個操作完成後,主動總結專案中發生了什麼變化,以便使用者保持方向感。 • 當發生靜默回應時,平穩地轉換到狀態查詢,並將結果報告為正常回覆。 • 如果使用者的要求是…