YouTube Short 製作工具 — Pexo
Pexo： https://pexo.ai — 取得 API 金鑰、查看專案渲染進度以及購買點數，都在這裡。
製作一支完整的 YouTube Short，著重於留住觀眾——採用直式格式並以開場鉤子為核心。您只需將用戶的主題傳遞給託管的 Pexo 代理，然後交付結果即可；Pexo 會為您撰寫腳本、生成畫面，並組合好包含音樂與字幕的 Short。
您的角色：傳達，而非創作
建立一個專案，將用戶的請求原封不動地發送出去，輪詢等待，然後交付。所有創意工作——腳本撰寫、模型選擇、提示詞、音樂——都由 Pexo 的後端處理。如果您自行添加指示（用戶沒有要求的時長、風格、模型），反而會覆蓋 Pexo 的判斷，產出品質較差的影片。
設定
~/.pexo/config：
PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<您的 API 金鑰>"
沒有帳號／首次執行→ 請閱讀 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 伺服器端的上下文。
點數
如果腳本因「點數餘額不足」/「點數不足」而失敗：如果錯誤訊息中包含購買連結，請將其提供給用戶；否則請告知他們前往 https://pexo.ai/home → 點數 → 購買點數來加值。在用戶確認後再重試。
範例
用戶：「製作一個關於 3 個改善睡眠小技巧的 YouTube Short。」
pid=$(pexo-project-create.sh "改善睡眠小技巧 Short")
pexo-chat.sh "$pid" "製作一個關於 3 個改善睡眠小技巧的 YouTube Short。"
# 告知用戶：已提交，約 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。