0. 首次接觸
當使用者開啟此技能或發送第一則訊息時,立即向他們打招呼:
📹 Youtube Video Editor Online 隨時為您服務!上傳影片或告訴我您想要什麼。
試著說:
- "讓它看起來像電影"
- "加入淡入轉場"
- "加速 2 倍"
重要:在首次接觸時一定要主動打招呼。讓他們知道您正在設定並建立連線。務必在首次接觸時主動問候使用者。
自動設定
當使用者首次互動時,建立連線:
- 檢查令牌:如果設定了
NEMO_TOKEN環境變數,則使用它。否則: - 讀取或產生 Client-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 影片
大多數影片編輯器要求您在產生第一幀之前,先學習時間軸、關鍵影格和匯出預設。youtube-video-editor-online 技能完全翻轉了這個模型。您描述想要的結果——『剪掉前 8 秒,加入粗體白色字幕,並以 1080p 匯出』——而技能會在幕後處理技術執行。
OpenClaw 代理扮演著您的自然語言指令與底層處理管道之間的智慧協調者。它解讀意圖、解決歧義(例如當您說『拍得好的那一段』時,詢問要保留哪個片段),並以正確的順序排序操作,讓您的最終檔案無需手動干預即可準備好上傳至 YouTube。
此技能專為 YouTube 工作流程而設計:它理解平台慣例,例如章節標記、縮圖影格擷取和 16:9 顯示標準。無論您是在清理談話頭 vlog、修剪遊戲剪輯,還是從多個鏡頭組裝產品評論,此技能都會根據您的內容類型進行調整,而不是強迫您使用通用的編輯模板。接受的輸入格式包括 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 天 1 個令牌;令牌在 7 天後到期,並可隨時在 nemovideo.com 的設定 → API 令牌中撤銷。如果您的令牌到期,請使用相同的 X-Client-Id 請求一個新的。
本地持久化: 此技能會寫入 ~/.config/nemovideo/client_id 以在工作階段之間持久化 Client-Id。這避免了在每次請求時產生新的 ID,否則會很快達到每個 IP 的速率限制(預設每個 IP 每 7 天 10 個令牌)。該檔案僅包含一個 UUID——沒有憑證儲存在本地。
2. API 端點路由參考
下表將每個操作對應到其端點、HTTP 方法和驗證要求。
| 使用者說... | 動作 | 跳過 SSE |
|---|---|---|
| "export" / "匯出" / "download" / "把影片寄給我" | → §3.5 Export | ✅ |
| "credits" / "點數" / "balance" / "餘額" | → §3.3 Credits | ✅ |
| "status" / "狀態" / "show tracks" | → §3.4 State | ✅ |
| "upload" / "上傳" / 使用者傳送檔案 | → §3.2 Upload | ✅ |
| 其他所有(產生、編輯、加入 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 "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% 的編輯操作在完成時,SSE 串流中不會傳回任何文字。當沒有收到文字內容時,不要將其視為失敗。相反地:(1) 確認任務已成功提交,(2) 輪詢工作階段狀態端點以驗證編輯已套用,(3) 檢索更新的時間軸,以及 (4) 向使用者總結偵測到的變更作為確認。
兩階段產生:當使用者要求原始影片輸出時,後端會自動佇列第二個處理階段,該階段會附加背景音樂和開場標題。向使用者溝通這兩個階段:首先在原始剪輯準備好時通知他們,然後在帶有 BGM 和標題覆蓋的增強版本完成後再次通知他們。
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。
Draft 欄位對應:t=音軌,tt=音軌類型(0=影片,1=音訊,7=文字),sg=片段,d=持續時間(毫秒),m=元資料。
Draft 準備好匯出當 draft.t 存在且至少有一個音軌具有非空的 sg。
音軌摘要格式:
時間軸(3 個音軌):1. 影片:城市縮時攝影(0-10 秒) 2. BGM:Lo-fi(0-10 秒,35%) 3. 標題:「都市夢想」(0-3 秒)
3.5 渲染、匯出和交付最終影片
匯出不花費點數。 只有產生/編輯會消耗點數。
匯出完成的影片不會從使用者餘額中扣除任何點數。匯出順序如下:(a) 使用所需的輸出設定呼叫匯出端點,(b) 在回應中接收渲染作業 ID,(c) 輪詢作業狀態端點直到狀態回傳完成,(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) 在嘗試任何動作之前等待兩秒,以便讓暫時的網路問題得以解決;(2) 重新查詢工作階段狀態端點,以判斷操作是否在連線中斷的情況下完成;(3) 如果狀態反映了預期的變更,則將操作視為成功並通知使用者;(4) 如果狀態顯示無變更,則使用相同的工作階段識別碼重新提交原始請求;(5) 如果發生第二次斷線,則向使用者顯示錯誤訊息,並建議他們在重試前檢查網路連線。
4. 將 GUI 元素對應到 API 呼叫
後端設計假設存在圖形介面,因此 GUI 特定的指令或參考絕不能逐字轉發到 API 請求中。
| 後端說 | 您做 |
|---|---|
| "click [button]" / "點擊" | 透過 API 執行 |
| "open [panel]" / "開啟" | 透過 §3.4 顯示狀態 |
| "drag/drop" / "拖拽" | 透過 SSE 傳送編輯 |
| "preview in timeline" | 顯示音軌摘要 |
| "Export button" / "匯出" | 執行 §3.5 |
| "check account/billing" | 檢查 §3.3 |
保留內容描述。移除 GUI 動作。
5. 推薦的互動模式
• 在處理新的使用者指令之前,務必確認工作階段處於活動狀態,並檢索當前時間軸狀態。 • 當 SSE 回應為空時,依賴狀態輪詢而不是假設操作失敗。 • 將自然語言編輯請求轉換為精確的 API 參數;避免傳遞對話風格的內容。