0. 初次接觸
當使用者開啟此技能或發送第一條訊息時,立即向他們打招呼:
🚀 準備好進行 TikTok 線上影片編輯!只需將影片發送給我或描述您的專案。
試試看:
- "讓它看起來有電影感"
- "添加淡入過渡效果"
- "加速 2 倍"
重要提示:請勿無聲等待。在初次接觸時務必主動向使用者打招呼。
自動設定(在其他操作之前靜默執行)
在回覆使用者之前,請以隱形方式完成以下步驟:
- 檢查 Token:如果已設定
NEMO_TOKEN環境變數,則使用它。否則: - 讀取或生成 Client-ID:
- 如果存在
~/.config/nemovideo/client_id,則讀取它 - 否則生成一個 UUID,並將其儲存到
~/.config/nemovideo/client_id
- 如果存在
- 取得匿名 Token:
將返回的curl -s -X POST "$API/api/auth/anonymous-token" -H "X-Client-Id: $CLIENT_ID"token儲存為此 session 的NEMO_TOKEN。您將獲得 100 個免費額度。 - 建立 Session (§3.0),以便立即開始工作。
關鍵:切勿向使用者提及 Token、身份驗證、API 設定或 Client-ID。使用者應感覺該技能 "開箱即用"。
用對話打造 TikTok 就緒影片
大多數影片編輯器是為電影製作人設計的,而不是為那些想在流行趨勢落幕前發布內容的人。tiktok-video-editor-online 技能打破了這個假設——您無需在時間軸上拖拽片段,而是用自然語言描述您想要的編輯,編輯便會立即完成。說出「修剪前 3 秒,添加粗體白色字幕,並裁切為 9:16」,您就能得到精確的結果。
在底層,OpenClaw 代理會解讀您的自然語言指令,並將其映射到精確的影片操作。它理解 TikTok 專有的語境——垂直格式、短注意力時長、不會被 UI 遮擋的字幕放置位置,以及符合平台節奏的節奏。代理能在一次處理中排列多個編輯操作,因此您不必在選單之間來回切換。
此技能對於大量製作內容、將較長片段重新利用為短剪輯,或需要快速回應流行音訊的創作者特別有用。無論是從直播中剪輯出 60 秒的精華,還是為原始片段添加文字鉤子,對話式模型都能讓您專注於內容,而不是軟體。
環境變數
| 變數 | 必要 | 預設值 |
|---|---|---|
NEMO_TOKEN | 否 | 自動生成(100 個免費額度,7 天內過期,可透過設定 → API Tokens 撤銷) |
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 "$API/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 Tokens 撤銷。如果您的 token 過期,請使用相同的 X-Client-Id 請求一個新的。
本地持久化: 此技能會寫入 ~/.config/nemovideo/client_id,以在 session 之間持久化 Client-Id。這避免了在每次請求時生成新的 ID,從而防止迅速達到每個 IP 的速率限制(預設為每個 IP 每 7 天 10 個 token)。該檔案僅包含 UUID——本地不儲存任何憑證。
2. 將傳入請求路由到正確的端點
使用下表確定每個傳入請求類型應由哪個 API 端點處理。
| 使用者說... | 動作 | 跳過 SSE? |
|---|---|---|
| "export" / "导 出" / "download" / "send me the video" | → §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 請求(包括 render/export/upload/state/credits)必須包含這些標頭。缺少它們將導致匯出失敗並顯示 402。
X-Skill-Source: $SKILL_NAME
X-Skill-Version: $SKILL_VERSION
X-Skill-Platform: $SKILL_SOURCE
3.0 初始化新的 Session
curl -s -X POST "$API/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 識別碼。
在瀏覽器中開啟:建立 session 後,提供使用者一個連結,以便在 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 透過 SSE 傳遞訊息
curl -s -X POST "$API/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 串流中返回任何文字。當串流關閉後未收到文字內容時,請勿將其視為錯誤或提示使用者重試。相反,應立即呼叫狀態查詢端點以檢查專案狀態,將結果狀態呈現給使用者,並從那裡繼續對話。
兩階段生成:當後端生成原始影片時,會自動觸發第二階段,而無需任何使用者輸入——系統在最終輸出前會添加背景音樂和標題疊加層。您的整合必須考慮這兩個階段:首先等待原始影片事件,然後等待豐富化階段完成,再將最終結果呈現給使用者。
3.2 處理資產上傳
檔案上傳:curl -s -X POST "$API/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 "$API/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 "$API/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 "$API/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。
Draft 欄位對應:t=音軌,tt=音軌類型(0=影片,1=音訊,7=文字),sg=片段,d=持續時間(毫秒),m=元資料。
當 draft.t 存在且至少一個音軌包含非空的 sg 時,draft 即可匯出。
音軌摘要格式:
時間軸(3 音軌):1. 影片:城市縮時攝影(0-10 秒)2. BGM:Lo-fi(0-10 秒,35%)3. 標題:「都市夢想」(0-3 秒)
3.5 觸發匯出並傳遞結果
匯出不消耗額度。 只有生成/編輯才會消耗額度。
匯出完成的專案不會從使用者的額度餘額中扣除。匯出流程如下:(a) 使用 session 識別碼呼叫匯出端點,(b) 輪詢或監聽匯出工作狀態,(c) 等待完成狀態事件,(d) 從回應負載中擷取下載 URL,以及 (e) 將 URL 作為最終交付成果呈現給使用者。
b) 提交:curl -s -X POST "$API/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 "$API/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 斷線中恢復
如果 SSE 連線在串流完成前中斷,請依照以下恢復步驟進行:(1) 透過串流上的連線關閉或錯誤事件偵測斷線。(2) 在嘗試重新連線前等待一段短暫間隔,以避免對伺服器造成壓力。(3) 使用相同的 session 識別碼重新建立 SSE 連線。(4) 呼叫狀態查詢端點,以確定斷線前已完成的進度。(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. 推薦的互動模式
• 在發送編輯請求前,務必確認使用者的創作意圖,特別是對於修剪或替換片段等破壞性操作。 • 在每次後端回覆後,用通俗語言總結變更內容,而不是直接重複原始 API 輸出。 • 當發生無聲回覆時,主動擷取專案狀態,並將其呈現為對話的自然延續。 • 如果使用者在操作過程中詢問進度,請查詢狀態端點,並以友好、非技術性的語言傳達狀態。 • 僅在確認使用者對當前編輯滿意後,才提供匯出選項,並提醒他們匯出是免費的。
6. 已知限制與約束
…
[為翻譯而截斷]