0. 首次接觸
當使用者開啟此技能或發送第一則訊息時,立即問候他們:
嘿!準備好製作出你最棒的 YouTube 影片了嗎?無論你需要修剪片段、調整節奏、加入字幕,還是匯出 YouTube 最佳化檔案——只要告訴我你在做什麼,我們就能快速完成。今天要編輯什麼?
試試看說:
- "將我的談話性訪談中所有超過 2 秒的靜音剪掉,並在每個剪接處加入微妙的放大效果,以保持節奏感。"
- "加入 YouTube Shorts 風格的自動字幕——粗體白色文字,置中,帶黑色外框——並匯出為垂直 mp4。"
- "將我 30 分鐘的 podcast 錄音,根據主題變化建立 YouTube 章節清單與時間戳,然後將開頭修剪至 30 秒以內。"
重要:首次接觸時務必主動問候使用者。讓他們知道你在連線時正在進行設定。
自動設定(首次使用)
當使用者首次開啟此技能時,執行以下設定步驟,並簡短通知他們正在連線(例如 "⚡ 正在連線至 NemoVideo..."):
- 檢查令牌:如果已設定環境變數
NEMO_TOKEN,則使用它。否則: - 讀取或產生用戶端 ID:
- 如果
~/.config/nemovideo/client_id存在則讀取 - 否則產生一個 UUID,並儲存至
~/.config/nemovideo/client_id - 此檔案僅儲存 UUID 以用於速率限制追蹤——不含任何機密或憑證。
- 如果
- 取得匿名令牌:
將回傳的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)以便立即開始工作。
透明度:保持設定通訊簡短——告訴使用者你正在連線至 NemoVideo 進行設定,但不要將原始 API 回應或令牌字串傾印到聊天中。使用者應知道正在進行設定,但不需要每個技術細節。
只需描述你想要的效果來編輯 YouTube 影片
best-youtube-video-editor 技能是專為 YouTube 創作者工作流程所設計——而非一般影片製作。無論是將 45 分鐘的談話影片剪成只有 8 分鐘的精彩片段、加入動態標題列作為頻道品牌識別,還是將背景音樂與場景轉場同步,此技能都理解 YouTube 原生概念,如觀眾保留編輯、鉤子最佳化和結尾畫面放置。
其核心採用對話式編輯模型。你不需要在時間軸上拖動片段,而是描述你的意圖:'移除所有超過 1.5 秒的停頓' 或 '在每個剪接處加入放大效果。' OpenClaw 代理會解讀這些指令,建構適當的編輯管道,並透過 NemoVideo API 後端執行變更——根據你的要求回傳預覽或最終渲染。
OpenClaw 代理也會在整個工作階段中維持上下文,讓你能自然地迭代:精細調整剪輯、還原調色,或重新以不同解析度匯出,而無需從頭開始。這使得此技能特別適合那些經常修改或同時處理多種影片格式(如 Shorts、標準上傳和嵌入式網頁內容)的創作者。
環境變數
| 變數 | 必要 | 預設值 | 功能說明 |
|---|---|---|---|
NEMO_TOKEN | 否 | 首次使用時自動透過 /api/auth/anonymous-token 取得(100 個免費積分,7 天後到期,可透過設定 → API 令牌撤銷) | 驗證 API 請求 |
NEMO_API_URL | 否 | https://mega-api-prod.nemovideo.ai | API 基礎 URL |
NEMO_WEB_URL | 否 | https://nemovideo.com | Web 基礎 URL |
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 個令牌;令牌在 7 天後到期,且可隨時在 nemovideo.com 上的設定 → API 令牌中撤銷。如果你的令牌到期,請使用相同的 X-Client-Id 請求新的令牌。
**本地持久化:**此技能會寫入 ~/.config/nemovideo/client_id 以在工作階段之間持久化 Client-Id。這避免了在每次請求時產生新 ID,否則會很快觸發基於 IP 的速率限制(預設每個 IP 每 7 天 10 個令牌)。該檔案僅包含一個 UUID——本地不儲存任何憑證。
2. 端點分派地圖 — 每個請求的路由位置
編輯器管道中的每個動作都會命中不同的端點——下表將每個操作對應到其正確目的地。
| 使用者說... | 動作 | 跳過 SSE? |
|---|---|---|
| "export" / "導出" / "download" / "把影片傳給我" | → §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 frontmattername$SKILL_VERSION= 此檔案的 YAML frontmatterversion$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 "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":"..."}}
在開始任何時間軸操作或片段處理之前,必須先建立工作階段——此呼叫建立後續所有請求依賴的工作區上下文。請保留回傳的工作階段 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 透過 Server-Sent Events 驅動編輯器
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 串流關閉且無助理訊息時:1) 立即呼叫狀態查詢端點以取得當前專案狀態。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. 標題:「Urban Dreams」(0-3 秒)
3.5 匯出並交付最終剪輯
匯出不消耗積分。 只有生成/編輯會消耗積分。
匯出完成的影片不消耗任何積分——無論帳戶餘額如何,匯出管道都可以自由呼叫。請按以下步驟進行:a) 透過狀態查詢端點確認時間軸狀態標記為完成。b) 使用目標解析度和格式參數呼叫匯出端點。c) 串流或輪詢匯出工作,直到後端回傳下載 URL。d) 將該 URL 作為最終渲染檔案傳遞給使用者。e) 記錄匯出工作 ID,以便後續疑難排解或重新下載請求。
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 下載 → 傳送給使用者。後備:$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 後重新連線
…[為翻譯而截斷]