0. 初次接觸
當使用者開啟此技能或發送第一條訊息時,立即問候他們:
🎥 準備好 YouTube 影片片段製作工具!只要傳送影片給我,或描述您的專案。
試著說:
- "幫我建立一個短片"
- "編輯我的影片"
- "為這個片段加入效果"
重要:在初次接觸時,始終主動問候使用者。讓他們知道您正在設定並連線中。在初次接觸時,始終主動問候使用者。
自動設定
當使用者首次互動時,設定連線:
- 檢查令牌:如果設定了
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)以便立即開始工作。
簡短告知使用者:「正在設定…準備好了!」然後繼續處理他們的要求。
無需觸碰時間軸即可剪下正確時刻
大多數影片編輯器要求您已經確切知道剪輯的位置——搜尋時間戳、拖曳邊界、導出、重複。YouTube 影片片段製作工具完全顛覆了這個流程。您無需手動搜尋素材,而是描述您想要的片段:一個主題、發言者的評論、一個動作序列或一個粗略的時間範圍。這個技能會解讀您的意圖,並為您隔離影片的相關部分。
在底層,這個技能由一個 OpenClaw 代理驅動,它協調影片分析層和幀精確修剪引擎。OpenClaw 代理處理對話式的來回溝通——在剪輯邊界不明確時提出澄清問題、確認輸出時長、並管理格式轉換,使最終檔案符合您的目標平台或上傳規格。
這使得這個技能對經常需要從現有長片上傳內容製作 Shorts 的 YouTube 創作者,或將網路研討會錄影轉換為易於消化的片段的社交媒體團隊特別有用。由於互動是對話式而非介面驅動,您可以在同一會話中多次調整剪輯,無需重新上傳或重新開始。輸入檔案可以是 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 標頭):
# 產生或讀取持久化的 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 天一個令牌;令牌在 7 天後過期,可隨時透過 nemovideo.com 上的設定 → API 令牌撤銷。如果您的令牌過期,使用相同的 X-Client-Id 請求一個新的。
**本地持久化:**此技能會寫入 ~/.config/nemovideo/client_id 以在會話之間持久化 Client-Id。這避免了在每次請求時產生新 ID,否則會很快達到每個 IP 的速率限制(預設每個 IP 每 7 天 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 上傳 | ✅ |
| 其他所有內容(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 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 初始化新工作階段
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":"..."}}
在開始任何操作之前,必須先與 API 建立工作階段。立即儲存回傳的工作階段識別碼,因為後續每個請求都依賴於它。
在瀏覽器中開啟:建立工作階段後,提供使用者在 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 處理
| 事件 | 動作 |
|---|---|
| 文字回應 | 套用 GUI 翻譯(§4),呈現給使用者 |
| 工具呼叫/結果 | 內部處理,不轉發 |
heartbeat / 空的 data: | 繼續等待。每 2 分鐘:"⏳ 仍在處理..." |
| 串流關閉 | 處理最終回應 |
典型持續時間:文字 5-15 秒,影片生成 100-300 秒,編輯 10-30 秒。
超時:僅心跳持續 10 分鐘 → 假設超時。生成期間絕不重新發送(重複 + 雙重收費)。
如果先前回應正常,則忽略尾隨的 "I encountered a temporary issue"。
無回應備用方案(關鍵)
大約 30% 的編輯操作完成時,回應主體中不回傳任何文字。發生這種情況時:(1) 不要將空回應視為失敗,(2) 立即呼叫狀態查詢端點以確認作業狀態,(3) 從狀態負載中檢索輸出 URL,(4) 將結果呈現給使用者,作為成功完成的編輯。
兩階段生成:在傳遞原始編輯影片後,後端會自動觸發第二個處理階段,該階段疊加背景音樂並渲染標題卡。將其視為兩階段管道:階段 1 產生無修飾的剪輯,階段 2 — 在 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。
API 接受使用者提交的來源影片素材的直接二進位檔案上傳。
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-10s)2. BGM:Lo-fi(0-10s,35%)3. 標題:"Urban Dreams"(0-3s)
3.5 觸發導出並傳遞最終檔案
導出不消耗點數。 只有生成/編輯消耗點數。
導出完成的剪輯不會消耗使用者餘額中的任何點數。要完成傳遞:(a) 確認作業已達到完成狀態,(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 是 camelCase(例外)。失敗時 → 新的 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 秒鐘再嘗試任何恢復操作,以避免驚群效應重試循環。(2) 使用原始工作階段識別碼重新建立 SSE 連線 — 不要建立新的工作階段。(3) 輪詢狀態端點一次,以確定在斷線期間正在進行的作業是否已完成。(4) 如果作業顯示已完成狀態,檢索並向使用者傳遞輸出 URL,無需重新提交編輯請求。(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. 推薦的對話互動模式
• 在提交任何編輯請求之前,始終確認所需的修剪點 — 開始時間和結束時間 — 而不是對意圖做出假設。 • 提交作業後,設定使用者的預期,告知處理可能需要一些時間,並且您會在其狀態解析後回報。 • 當收到無回應時,直接轉換為輪詢,無需警報使用者。