Startup Video — Pexo
Pexo： https://pexo.ai — 取得 API 金鑰、在該處觀看專案渲染並購買點數。
為你的新創公司製作完整的品牌或簡介影片。你只需轉達創辦人的簡報 — 或你的網站 — 給託管的 Pexo 代理，然後交付結果；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 → 點數 → 購買點數來增加點數。在用戶確認後重試。
範例
用戶：「為我們的新創公司製作一部 30 秒的簡介影片 — 一個在地農夫市集。」
pid=$(pexo-project-create.sh "startup intro video")
pexo-chat.sh "$pid" "為我們的新創公司製作一部 30 秒的簡介影片 — 一個在地農夫市集。"
# 告知用戶：已提交，約 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