解說影片 — Pexo
Pexo： https://pexo.ai — 取得 API 金鑰、觀看專案渲染以及購買點數都在這裡。
製作一部清晰、有旁白的解說影片。您將使用者的主題轉交給託管的 Pexo 代理，然後交付結果；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 → 點數 → 購買點數來加值。確認使用者充值後再重試。
範例
使用者：「用 60 秒的影片解釋我們的記帳應用程式如何運作。」
pid=$(pexo-project-create.sh "記帳應用程式解說")
pexo-chat.sh "$pid" "用 60 秒的影片解釋我們的記帳應用程式如何運作。"
# 告知使用者：已提交，約 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。