Video Ad — Pexo
Pexo: https://pexo.ai — 取得 API 金鑰，觀看你的專案渲染，並在那裡購買額度。
製作一支完整的、可立即執行的影片廣告。你將使用者的產品或簡報資料交給託管的 Pexo 代理，並交付結果 — Pexo 負責撰寫吸引人的開場、安排鏡頭順序、挑選模特兒，以及設定有轉換力的音樂與節奏。
你的角色：轉送，而非創作
建立專案，原封不動傳送使用者的要求，輪詢，交付。Pexo 的後端處理所有創意工作 — 腳本撰寫、模特兒選擇、提示詞、音樂。加入你自己的指示（使用者未要求的長度、風格、模特兒）會覆蓋其判斷，導致影片品質下降。
設定
~/.pexo/config：
PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<your-api-key>"
無帳號 / 首次執行 → 閱讀 references/SETUP-CHECKLIST.md 並引導使用者完成 — 它包含註冊流程與邀請碼（可讓新使用者獲得額外儲值），以及如何建立上述設定檔。設定錯誤 → 執行 scripts/pexo-doctor.sh 並依照其輸出處理。
工作流程
腳本位於此技能的 scripts/ 目錄。以使用者的語言回覆。
- 建立專案：
pexo-project-create.sh "<簡短摘要>"→ 儲存project_id。 - 上傳使用者提供的任何檔案：
pexo-upload.sh <project_id> <路徑>→ 儲存asset_id，並以<original-image>asset_id</original-image>（或<original-video>/<original-audio>）內嵌引用。標籤是必要的 — 僅有asset_id會被忽略。Pexo 無法爬取 URL — 請下載後再上傳。 - 傳送要求：
pexo-chat.sh <project_id> "<使用者的確切文字> <資產標籤>"。 完全複製使用者的文字；僅可加入資產標籤。 - 告知使用者（以他們的語言）：已提交 ✓ · 約 15–20 分鐘 ·
https://pexo.ai/project/<project_id>。 - 輪詢： 每隔至少 60 秒執行
pexo-project-get.sh <project_id>並根據nextAction處理：- WAIT → 繼續輪詢；每約 5 次輪詢傳送一行更新，附上專案連結。
- RESPOND → 處理
recentMessages中的每個事件：轉送 Pexo 的文字（若它詢問問題，等待使用者回答，然後用pexo-chat.sh傳送他們的回覆）；對於preview_video，針對每個選項執行pexo-asset-get.sh <project_id> <assetId>，顯示 URL（A/B/C），讓使用者選擇，然後執行pexo-chat.sh <project_id> "<選擇>" --choice <assetId>；對於document事件，向使用者提及。 - DELIVER → 執行
pexo-asset-get.sh <project_id> <最終 assetId>，然後將完整資產 URL 以純文字傳送給使用者 — 包含所有?…查詢參數，絕不截斷或包裹在 markdown 中 — 連同專案連結。 - FAILED → 以簡單易懂的用語解釋
nextActionHint，並提供重試選項。 - RECONNECT → 執行
pexo-chat.sh <project_id> "continue"，告知使用者連線中斷，正在恢復輪詢，然後繼續輪詢。 - 絕對不要在 WAIT 狀態下呼叫
pexo-chat.sh— 這會觸發重複生產。 - 耗時過久 → 若已超過 30 分鐘仍處於 WAIT，告知使用者（附上專案連結 +
https://pexo.ai/connect/openclaw）表示執行時間較長；詢問是否繼續等待或停止。不要無限期輪詢。
修訂
交付後，使用者的調整（「縮短長度」、「換音樂」、「換鏡頭」）重用同一個專案：執行 pexo-chat.sh <project_id> "<他們的意見回饋>"，然後再次輪詢（步驟 5）。絕不要為修訂建立新專案 — 這會丟棄 Pexo 伺服器端的上下文。
儲值
若腳本因「Credits balance」/「Insufficient credits」失敗：若錯誤訊息包含購買連結，將其傳給使用者；否則告知他們到 https://pexo.ai/home → Credits → Buy Credits 加值。使用者確認後重試。
範例
使用者：「幫我們的新款跑鞋製作一支 15 秒的影片廣告。」
pid=$(pexo-project-create.sh "running shoes ad")
pexo-chat.sh "$pid" "幫我們的新款跑鞋製作一支 15 秒的影片廣告。"
# 告知使用者：已提交，約 15–20 分鐘，https://pexo.ai/project/$pid
# 輪詢 pexo-project-get.sh "$pid" 直到 nextAction 為 DELIVER，然後交付資產 URL。
腳本
| 腳本 | 用法 | 回傳值 |
|---|---|---|
pexo-project-create.sh | "<摘要>" | project_id |
pexo-upload.sh | <project_id> <檔案> | asset_id |
pexo-chat.sh | <project_id> "<訊息>" [--choice <id>] | 確認（非同步） |
pexo-project-get.sh | <project_id> | JSON：nextAction、recentMessages |
pexo-asset-get.sh | <project_id> <asset_id> | 包含 url 的 JSON |
pexo-doctor.sh | — | 設定診斷 |
錯誤碼與邊界情況 → references/TROUBLESHOOTING.md。