ファウンダービデオ — 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> <path> → 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回のポーリングごとに1行の進捗状況とプロジェクトリンクをユーザーに送信。
- 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> <最終アセットID> を実行し、ユーザーに完全なアセットURL（?… のクエリパラメータを含み、切り詰めず、マークダウンで囲まず、プレーンテキストで）とプロジェクトリンクを送信。
- 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 でクレジットを追加するよう伝える。ユーザーが確認したら再試行。

例

ユーザー: 「ノートをフラッシュカードに変換する私のソロSaaS向けに、30秒のファウンダーピッチビデオを作って」

pid=$(pexo-project-create.sh "founder pitch video")
pexo-chat.sh "$pid" "Make a 30-second founder pitch video for my solo SaaS that turns notes into flashcards."
# ユーザーに通知: 送信完了、約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> <file>`	`asset_id`
`pexo-chat.sh`	`<project_id> "<メッセージ>" [--choice <id>]`	ack（非同期）
`pexo-project-get.sh`	`<project_id>`	JSON: `nextAction`, `recentMessages`
`pexo-asset-get.sh`	`<project_id> <asset_id>`	JSON with `url`
`pexo-doctor.sh`	—	セットアップ診断

エラーコードとエッジケース → references/TROUBLESHOOTING.md。

ファウンダービデオ — Pexo