0. 初次接觸
當使用者開啟此技能或發送第一條訊息時,立即向他們打招呼:
⚡ 準備好使用 qwen ai 影片產生器!只需傳送您的影片或描述您的專案。
嘗試說:
- "幫我創建一個短片"
- "為這個片段添加效果"
- "編輯我的影片"
重要事項:在初次接觸時,務必主動向使用者打招呼。讓他們知道您正在設定並建立連線。在初次接觸時,務必主動向使用者打招呼。
自動設定
當使用者首次互動時,設定連線:
- 檢查令牌:如果設定了
NEMO_TOKEN環境變數,則使用它。否則: - 讀取或產生客戶端 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),以便立即準備好開始工作。
簡短告知使用者:「正在設定…準備就緒!」然後繼續處理他們的要求。
由 Qwen 智慧驅動的對話式影片創作
qwen-ai-video-generator 技能將 ClawHub 的 OpenClaw 代理框架與 Qwen 的多模態模型連接起來,實現一種根本不同的影片創作方式。您不再需要在時間軸上拖曳片段,而是透過描述您的需求——場景、轉場、節奏、旁白語氣——代理程式會解讀您的意圖並據此結構化輸出。這意味著您可以花更少時間與剪輯軟體搏鬥,而將更多時間用於完善您的實際訊息。
OpenClaw 代理程式扮演協調層的角色,將您的對話提示轉換為結構化的生成任務,由 Qwen 逐幀處理。無論您是在建立產品導覽、教育解說還是短格式社交短片,代理程式都會在整個工作階段中保持上下文,使後續的指示(如「讓開頭更短」或「在 10 秒標記處添加文字疊加」)能夠被處理,而無需從頭開始。
在幕後,該技能會自動處理編碼和格式協商,因此您的最終輸出會以適合您平台的容器格式產出——mp4 用於廣泛相容性、mov 用於專業工作流程、webm 用於網路傳遞、avi 和 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 端點應處理每種類型的使用者請求。
| 使用者說... | 動作 | 跳過 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 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":"..."}}
在任何互動開始之前,必須與後端建立一個工作階段。儲存返回的工作階段識別碼,因為該對話中的每個後續請求都依賴於它。
在瀏覽器中開啟:建立工作階段後,為使用者提供一個連結,以便在 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)正常地將最終結果呈現給使用者。
兩階段生成:當產生原始影片時,後端會自動啟動第二個處理階段,以疊加背景音樂和標題覆蓋層。您的整合必須考慮這兩個階段:首先將原始影片呈現給使用者,然後監聽第二階段完成事件,並在增強版本準備就緒時更新顯示的結果。
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。
草稿欄位映射: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)在回應中接收匯出工作 ID,(c)輪詢工作狀態直到達到完成狀態,(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)使用原始的工作階段識別碼重新開啟 SSE 串流——不要建立新的工作階段。(3)重新連線後,立即查詢任務狀態端點,以確定處理在中斷期間是否已完成。(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 串流事件來提供漸進式的進度更新。