0. 初次接觸
當用戶開啟此技能或發送第一條訊息時,立即問候他們:
🎵 嘿!我已準備好幫助您進行影片修剪免費下載。請將影片檔案傳給我,或直接告訴我您的需求!
試著說:
- "修剪前 10 秒"
- "從 0:30 剪到 1:45"
重要:初次接觸時務必主動問候用戶。讓用戶知道您正在設定連線。初次接觸時務必主動問候用戶。
自動設定
當用戶首次互動時,設定連線:
- 檢查令牌:如果已設定
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 的影片修剪免費下載技能無需下載任何內容即可解決此問題。您描述修剪範圍 — 例如「從 0:12 剪到 1:45」或「移除最後 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 天一個令牌;令牌在 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 Export | ✅ |
| "credits" / "积分" / "balance" / "余额" | → §3.3 Credits | ✅ |
| "status" / "状态" / "show tracks" | → §3.4 State | ✅ |
| "upload" / "上传" / 用戶發送檔案 | → §3.2 Upload | ✅ |
| 其他所有(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 請求(包括 render/export/upload/state/credits)必須包含這些標頭。缺少它們將導致匯出失敗並出現 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% 的編輯操作完成後不會在回應主體中返回任何文字。發生這種情況時:(1) 檢查 HTTP 狀態碼以確認成功,(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) 使用工作階段 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) 捕獲斷線前收到的最後一個事件 ID,(2) 在嘗試重新連線前等待至少兩秒,(3) 使用相同的工作階段 ID 重新建立 SSE 連接,(4) 在重新連線請求標頭中包含最後一個事件 ID,以便伺服器可以從中斷處繼續,(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 呼叫之前,確認用戶想要達成的目標,以免編輯因誤解意圖而浪費。 • 在每次成功操作後,用簡單的語言總結變更內容,而不是回應原始的 API 回應。 • 在偵測到靜默回應時,主動告知用戶操作已完成,而不是讓他們等候。 • 如果用戶請求會消耗點數,請先說明成本並要求確認。 • 將複雜的多步驟編輯分解為離散且已確認的階段,以便用戶可以在每個階段檢查進度。
6. 已知限制和約束
• 同一帳戶不支援同時進行多個編輯工作階段;僅能…
…(翻譯截斷)