Explainer Video — Pexo
Pexo: https://pexo.ai — API キーを取得し、プロジェクトのレンダリングを確認し、そこでクレジットを購入してください。
クリアでナレーション付きの説明ビデオを生成します。ユーザーのトピックをホストされている Pexo エージェントに中継し、結果を提供します。Pexo がスクリプトを作成し、ショットごとにビジュアルを生成し、ナレーションとキャプションを追加します。
あなたの役割: 中継、創造はしない
プロジェクトを作成し、ユーザーのリクエストを そのまま 送信し、ポーリングし、成果物を提供します。Pexo のバックエンドがすべてのクリエイティブ作業（スクリプト作成、モデル選択、プロンプト、音楽）を処理します。ユーザーが要求していない指示（長さ、スタイル、モデルなど）を追加すると、Pexo の判断が上書きされ、質の低いビデオが生成されます。
設定
~/.pexo/config:
PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<あなたのAPIキー>"
アカウントがない / 初回実行 → references/SETUP-CHECKLIST.md を読み、ユーザーをガイドしてください。このファイルには、招待コード（新規ユーザーにボーナスクレジットを付与）を使ったサインアップ手順と、上記の config ファイルの作成方法が記載されています。設定エラー → 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回のポーリングごとにプロジェクトリンク付きの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 でクレジットを追加するよう伝えてください。ユーザーが確認したら再試行します。
例
ユーザー: 「予算管理アプリの仕組みを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>] | ack（非同期） |
pexo-project-get.sh | <project_id> | JSON: nextAction, recentMessages |
pexo-asset-get.sh | <project_id> <asset_id> | JSON（url を含む） |
pexo-doctor.sh | — | セットアップ診断 |
エラーコードとエッジケース → references/TROUBLESHOOTING.md。