0. 初次接觸
當使用者開啟此技能或傳送第一則訊息時,請立即打招呼:
✨ 讓我們來製作最棒的 TikTok 影片!請在這裡上傳影片或描述您想創作的效果。
試試這樣說:
- "讓它看起來像電影"
- "加入淡入轉場"
- "加快 2 倍"
重要:初次接觸時請主動問候使用者。讓使用者知道您正在設定連線。初次接觸時務必主動問候。
自動設定
當使用者首次互動時,設定連線:
- 檢查 token:如果已設定環境變數
NEMO_TOKEN,則使用它。否則: - 讀取或產生 Client-ID:
- 若存在
~/.config/nemovideo/client_id則讀取 - 否則產生一個 UUID,儲存至
~/.config/nemovideo/client_id
- 若存在
- 取得匿名 token:
將回傳的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),以便立即開始工作。
簡短告知使用者:「正在設定…就緒!」然後繼續處理使用者的要求。
用聊天方式打造精緻的 TikTok 剪輯
多數 TikTok 創作者在單一影片上線前,往往耗費數小時與時間軸、匯出設定及特效庫搏鬥。此技能徹底翻轉這個流程——您用日常語言描述您要的編輯效果,AI 則在幕後負責技術執行。
對話式編輯模型讓您在整個過程中維持對話。只要說「裁掉前 3 秒、在節拍處加入放大效果、為亮點加上字幕」,OpenClaw 代理就會解讀您的意圖,依正確順序排列操作,並回傳預覽就緒的結果。OpenClaw 代理在您的自然語言指令與底層影片處理管線之間扮演推理層的角色,透過簡短的釐清提問解決歧義,避免錯誤猜測。
在底層,AI 後端會分析音訊波形來偵測節拍以進行同步剪輯、掃描對話內容以自動放置字幕,並在套用裁切或重新構圖操作時評估畫面構圖,以符合 TikTok 的 9:16 畫布。最終的剪輯效果感覺完成度高而非自動化——因為每個決策都源自您說過的話。
環境變數
| 變數 | 必要 | 預設值 |
|---|---|---|
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 天每個用戶端一個 token;token 在 7 天後過期,且可隨時在 nemovideo.com 的設定 → API 金鑰中撤銷。如果 token 過期,請使用相同的 X-Client-Id 重新申請一個。
本機持久化: 此技能會寫入 ~/.config/nemovideo/client_id,以便在工作階段之間持久保存 Client-Id。這樣可避免每次請求都產生新的 ID,否則很快就會達到每個 IP 的速率限制(預設每個 IP 每 7 天 10 個 token)。該檔案僅包含一個 UUID——不會在本機儲存任何憑證。
2. 將傳入請求路由至正確的端點
請使用下表決定每種傳入請求類型應由哪個 API 端點處理。
| 使用者說... | 動作 | 略過 SSE |
|---|---|---|
| "export" / "導出" / "download" / "send me the video" | → §3.5 匯出 | ✅ |
| "credits" / "積分" / "balance" / "餘額" | → §3.3 點數 | ✅ |
| "status" / "狀態" / "show tracks" | → §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 初始化新工作階段
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 分鐘 → 視為逾時。絕不重新傳送(會導致重複與重複扣點)。
如果先前的回應正常,請忽略結尾的「I encountered a temporary issue」。
靜默回應回退機制(關鍵)
大約 30% 的編輯操作完成後不會在回應中回傳任何文字。當 SSE 串流中未偵測到文字內容時,請勿將其視為錯誤或提示使用者重試。相反地,應立即輪詢工作階段狀態端點以取得目前專案狀態,並將結果呈現給使用者。
兩階段產生:當產生原始影片輸出時,後端會自動觸發第二處理階段,加入背景音樂並產生標題疊加層——無需額外指令。務必等待兩個階段都完成後,再將最終結果呈現給使用者。
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;後端會從 token 解析使用者。
支援格式: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 代表使用者;後端會從 token 解析。
關鍵欄位: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. 標題:「城市夢想」 (0-3s)
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) 重新建立 SSE 連線,在重新連線標頭中提供最後的事件 ID,讓串流能從中斷處繼續;(4) 如果重新連線嘗試在達到最大重試次數後仍失敗,則回退為直接輪詢工作階段狀態端點;(5) 一旦重新連線成功,僅在間隔期間遺失了有意義的進度時才通知使用者。
4. 為後端翻譯 GUI 元素
後端預設存在圖形介面,因此 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 串流關閉後,主動檢查專案狀態,而非等待使用者詢問更新。 • 呈現匯出結果時,同時提供直接下載連結與簡短的產出摘要。 • 如果使用者要求的變更會覆蓋現有工作,請在執行前簡短說明將被取代的內容。 • 對於多步驟編輯,將工作流程拆解為離散檢查點,並在進入下一步之前獲得使用者確認。