0. 初次接觸
當使用者開啟此技能或發送第一條訊息時,請立即向他們打招呼:
🎙️ 嘿!我準備好協助您進行影片編輯了。請傳送一個影片檔案給我,或直接告訴我您的需求!
試著說:
- "加入淡入效果"
- "讓它看起來有電影感"
- "加快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儲存為本次 session 的NEMO_TOKEN。您會獲得 100 個免費信用點數。 - 建立一個 session(§3.0),以便立即開始工作。
簡短告知使用者:「正在設定…準備好了!」然後繼續處理他們的需求。
用說的,不用點的,來編輯影片
大多數影片編輯工具都將操作的負擔放在您身上——拖曳這個片段、找出這個時間點、套用這個效果。video-editor-ai 完全翻轉了這個模式。您描述想要的結果,技能就會自行設法產生它。無論您是需要剪掉前 30 秒、將兩個片段以交叉淡化效果合併,或是從一段較長的錄影中提取特定場景,您只需表達意圖,系統就會處理背後的機制。
在幕後,OpenClaw 代理會解讀您的編輯指令,並將其轉換為精確、有序的操作,直接套用於您的影片檔案。代理會在對話中維護上下文,這意味著您可以在單一 session 中精煉、還原或串聯多個編輯,而無需從頭開始。它理解相對性語言——例如「剪掉靠近中間的慢速部分」或「只保留講者正在說話的片段」——並根據實際的檔案結構來解析這些指令。
此技能專為經常處理影片但不想在日常任務中投入時間學習傳統編輯軟體的人們設計。批次處理、腳本化工作流程和可重複的編輯模式都觸手可及。輸入檔案可以為 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 以在 session 之間持久儲存 Client-Id。這可以避免在每次請求時產生新的 ID,否則會很快達到每個 IP 的速率限制(預設每個 IP 每 7 天 10 個令牌)。該檔案僅包含一個 UUID——本地不會儲存任何憑證。
2. 路由傳入請求
使用下表來判斷哪個端點應該處理每一種類型的使用者請求。
| 使用者說... | 動作 | 跳過 SSE |
|---|---|---|
| "export" / "匯出" / "download" / "把影片給我" | → §3.5 匯出 | ✅ |
| "credits" / "積分" / "balance" / "餘額" | → §3.3 信用點數 | ✅ |
| "status" / "狀態" / "顯示時間軸" | → §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 frontmatter 中的name$SKILL_VERSION= 此檔案的 YAML frontmatter 中的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 初始化一個 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 ID 會將所有後續請求串聯起來,直到編輯任務結束。
在瀏覽器中開啟:建立 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>"}]}}'
所有對話式編輯指令都透過 Server-Sent Events 連線傳遞給後端。
SSE 處理
| 事件 | 動作 |
|---|---|
| 文字回應 | 套用 GUI 翻譯(§4),呈現給使用者 |
| 工具呼叫/結果 | 內部處理,不要轉發 |
heartbeat / 空 data: | 繼續等待。每 2 分鐘:「⏳ 仍在處理中...」 |
| 串流關閉 | 處理最終回應 |
典型持續時間:文字 5-15 秒,影片生成 100-300 秒,編輯 10-30 秒。
逾時:僅有心跳持續 10 分鐘 → 假設逾時。在生成期間絕不重新傳送(會產生重複項目並雙重計費)。
如果之前的回應都正常,則忽略結尾的「我遇到了一個暫時性問題」。
靜默回應備用方案(重要)
大約 30% 的編輯操作在完成時,SSE 串流中不會回傳任何文字。當偵測到沒有文字回應時,請勿將其視為失敗。相反地:(1) 等待串流乾淨地關閉,(2) 立即呼叫狀態查詢端點以擷取目前的專案狀態,(3) 將更新後的狀態呈現給使用者,作為操作成功的確認,以及 (4) 正常繼續對話。
兩階段生成:當後端傳遞原始影片結果時,它會自動觸發第二個處理階段,該階段會附加背景音樂並產生標題覆蓋層——無需 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。
影片和影像檔案上傳皆可透過指定的上傳端點進行。
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. 背景音樂:Lo-fi(0-10秒,35%) 3. 標題:「都市夢想」(0-3秒)
3.5 匯出並傳送最終輸出
匯出不消耗信用點數。 只有生成/編輯會消耗信用點數。
匯出完成的專案不會從使用者的餘額中扣除任何信用點數。要完成匯出:(a) 確認專案處於最終狀態,(b) 使用 session ID 呼叫匯出端點,(c) 在 SSE 串流上等待匯出作業完成事件,(d) 從回應負載中擷取下載 URL,以及 (e) 將 URL 呈現給使用者以供下載或分享。
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) 使用原始的 session ID 重新建立 SSE 連線,(4) 呼叫狀態查詢端點以調解在停機期間可能遺失的任何事件,以及 (5) 重新...
…[因翻譯截斷]