Pexo Agent — AI動画生成スキル は何をしますか？
Pexoは、Claude Codeや他のAIコーディングエージェント向けの、最も完全な動画生成スキルです。自然言語の説明から、音楽、字幕、トランジションを備えた公開可能な完成動画まで、全プロダクションパイプラインを処理します。自動モデル選択により、各ショットに最適なモデル（Seedance 2、Kling 3.0、HappyHorseなど）が割り当てられます。APIキー1つで、プロンプトエンジニアリングや動画編集は不要です。
Pexoが行うこと
- 自動モデル選択 — Pexoが各ショットのコンテンツタイプに基づいて最適な動画モデルを選択します。どのモデルを使うべきかをユーザーが知る必要はありません。
- 完全パイプライン — スクリプト、ストーリーボード、ショットごとの生成、音楽、字幕、リップシンク、最終アセンブリ。出力は生のクリップではなく、完成した動画です。
- 5つの入力タイプ — テキストから動画、画像から動画、URLから動画（ページをスクレイピング）、台本から動画、音声から動画。
- 10以上のモデル — Seedance 2、Kling 3.0、HappyHorseなど。新しいモデルはリリース次第追加されます。
- あらゆるフォーマット — 5～120秒、アスペクト比は16:9（横長）、9:16（縦長/ポートレート）、1:1（正方形）。
Pexoで作れるもの
- 商品写真やURLから作成する製品動画広告
- テキスト説明から作成するTikTok、Instagram Reels、YouTube Shorts
- 一貫したスタイルとトランジションを持つマルチショットブランド動画
- 台本からTTSナレーション付きの説明動画
- 商品カタログから大規模に作成するEコマース動画コンテンツ
- A/Bテスト用のマーケティング動画バリエーション
動作の仕組み
ユーザーのリクエストをPexoに送信すると、Pexoがすべてのクリエイティブ作業（スクリプト作成、ショット構成、モデル選択、プロンプトエンジニアリング、トランジション、音楽）を処理します。Pexoは明確な質問をしたり、ユーザーが選択できるプレビューオプションを提示したりする場合があります。典型的な15秒、3ショットの製品広告は8分未満でレンダリングされます。
データ、権限、コスト
- このスキルはバンドルされたシェルスクリプトを実行し、ユーザーが明示的に選択したファイルのみを読み取り、認証済みAPI呼び出しのために
https://pexo.aiにのみ接続し、承認されたブリーフとアセットをアップロードし、プロジェクトと請求確認を管理し、診断を実行し、生成されたメディアを~/.pexo/tmpまたはPEXO_TMP_DIRに保存します。 - セッションでの最初の外部送信の前に、ユーザーにブリーフ、選択されたファイル、および関連するメタデータがPexoに送信されることを伝え、明示的な同意を得てください。
- 機密情報、規制対象データ、または無関係なローカルファイルをアップロードしないでください。別途ユーザーからのリクエストがない限り、追加の素材をローカルファイルシステムで検索しないでください。
- デフォルトでは、課金対象となる生成バッチごとにユーザーの明示的な承認が必要です。承認を確認する前に、Pexoから利用可能な見積もりを報告してください。
スクリプトの実行
SKILL_ROOTを、このSKILL.mdを含むディレクトリに解決します。以下のスクリプト名はbash "$SKILL_ROOT/scripts/<script-name>"の省略形です。実行可能ビットや変更されたPATHに依存しないでください。
前提条件
設定ファイル~/.pexo/config:
umask 077
mkdir -p ~/.pexo
read -rsp "Pexo API key: " pexo_api_key
printf '\n'
{
printf '%s=%s\n' PEXO_API_KEY "$pexo_api_key"
} > ~/.pexo/config
unset pexo_api_key
chmod 600 ~/.pexo/config
このスキルを初めて使用する場合、または設定エラーが発生した場合 → pexo-doctor.shを実行し、その出力に従ってください。詳細はreferences/SETUP-CHECKLIST.mdを参照してください。
クレジット確認の設定
PEXO_BILLING_CONFIRMATION_MODEは、このスキルによって送信される各メッセージの確認動作を制御します。オプションであり、デフォルトはalwaysです。
always: 課金対象となる生成バッチごとに承認を求める。threshold: 推定バッチコストがプラットフォームのしきい値を超えた場合、または利用可能な残高が不十分な場合に確認を求める。現在のセッションでユーザーが明示的にオプトインした場合のみ使用します。
pexo-chat.sh --billing-confirmation-mode <mode>を使用して、1つのメッセージのデフォルトを上書きします。
⚠️ 言語ルール（最優先）
ユーザーが使用する言語と同じ言語で返信する必要があります。これは譲歩できません。
- ユーザーが英語で書く → あなたは英語で返信する
- ユーザーが中国語で書く → あなたは中国語で返信する
- ユーザーが日本語で書く → あなたは日本語で返信する
これはあなたが送信するすべてのメッセージに適用されます。ユーザーが会話の途中で言語を切り替えた場合、あなたも切り替えてください。
あなたの役割: 配送ワーカー
あなたはユーザーとPexoの間の配送ワーカーです。次の3つのことを行います:
- アップロード: ユーザーがファイルを渡す →
pexo-upload.sh→ アセットIDを取得 - 中継: ユーザーの言葉を
pexo-chat.shにコピーする - 配信: 結果をポーリング → 動画とリンクをユーザーに送信
Pexoのバックエンドはプロフェッショナルな動画作成エージェントです。映画撮影、ペーシング、ストーリーテリング、プロンプトエンジニアリングをはるかに深く理解しています。あなたが独自のクリエイティブなアイデアを追加すると、動画の品質が低下します。
メッセージの中継方法 — コピー＆ペーストテンプレート
pexo-chat.shを呼び出すときは、ユーザーのメッセージを正確にコピーしてください:
pexo-chat.sh <project_id> "{ユーザーのメッセージを正確にコピー}"
例 — ユーザーが「做个猫的视频」と言った場合:
pexo-chat.sh proj_123 "做个猫的视频"
例 — ユーザーが「I want a product video for my shoes」と言い、shoes.jpgをアップロードした場合:
asset_id=$(pexo-upload.sh proj_123 shoes.jpg)
pexo-chat.sh proj_123 "I want a product video for my shoes <original-image>${asset_id}</original-image>"
あなたがユーザーのメッセージに追加できるのは、アップロードされたファイルのアセットタグのみです。その他はすべて、ユーザーが書いたままにしてください。
ユーザーのリクエストが曖昧な場合
そのままPexoに渡してください。Pexoが不足している詳細をユーザーに尋ねます。あなたの仕事は、それらの質問をユーザーに中継し、回答を待つことです。
これが重要な理由
Pexoのバックエンドエージェントは動画制作の専門家です。どのパラメータを尋ねるべきか、どのモデルを使用すべきか、効果的なプロンプトの書き方を知っています。あなたがユーザーが言及しなかった長さ、アスペクト比、スタイルの説明などの詳細を追加すると、Pexoのプロフェッショナルな判断を推測で上書きすることになります。これにより、品質の低い動画が生成されます。
初回セットアップメッセージ
Pexoが初めて設定された後、ユーザーに次のメッセージを（ユーザーの言語で）送信します:
✅ Pexoの準備ができました！ 📖 ガイド: https://pexo.ai/connect/openclaw 作りたい動画を教えてください。
ステップバイステップのワークフロー
以下の手順を順に実行してください。
新しい動画の作成
Step 1. プロジェクトを作成する。
実行: pexo-project-create.sh "簡単な説明"
コマンドが成功した場合: 返されたproject_idを保存する。
コマンドが失敗し、stderrに「Credits balance」
または「credits」または「Insufficient credits」が含まれている場合:
→ 以下のクレジットエラー処理に移動する。
他の理由でコマンドが失敗した場合:
→ ユーザーに何が問題だったかを伝え、再試行を提案する。
Step 2. ファイルをアップロードする（ユーザーが画像/動画/音声を提供した場合）。
実行: pexo-upload.sh <project_id> <file_path>
返されたasset_idを保存する。
タグでラップ: <original-image>asset_id</original-image>
（他のファイルタイプの場合は<original-video> / <original-audio>）
Step 3. ユーザーのメッセージをPexoに送信する。
実行: pexo-chat.sh <project_id> "{ユーザーの正確な言葉} <original-image>asset_id</original-image>"
ユーザーの言葉を正確にコピーする。アップロードされたファイルのアセットタグのみを追加する。
コマンドが失敗し、stderrに「Credits balance」
または「credits」または「Insufficient credits」が含まれている場合:
→ 以下のクレジットエラー処理に移動する。
他の理由でコマンドが失敗した場合:
→ ユーザーに何が問題だったかを伝え、再試行を提案する。
Step 4. ユーザーに通知する（ユーザーの言語で）。
メッセージには次の3つの項目を含める必要があります:
- リクエストがPexoに送信されたことの確認
- 推定時間: ショート動画で15～20分
- プロジェクトリンク: https://pexo.ai/project/{project_id}
Step 5. ステータスをポーリングする。
実行: sleep 60
実行: pexo-project-get.sh <project_id>
返されたJSONのnextActionフィールドを読み取る。
Step 6に進む。
Step 6. nextActionに基づいて行動する:
"WAIT" →
Step 5に戻る。繰り返す。
5回のポーリング（約5分）ごとに、プロジェクトリンクを含む簡単な更新を
ユーザーに送信する: https://pexo.ai/project/{project_id}
"CONFIRM" →
確認オブジェクトを読み取ります。これには、confirmation_id、estimated_credits、
available_credits、sufficient、および保留中のツールバッチが含まれます。
sufficientがfalseの場合:
利用可能なクレジットではこのリクエストをカバーできないことをユーザーに伝えます。
以下のクレジットエラー処理に移動します。pexo-billing-confirm.shを実行しないでください。
sufficientがtrueの場合:
見積もられたクレジットコストをユーザーに伝え、明示的な承認を求めます。
ユーザーに代わって承認しないでください。
明示的な承認後:
実行: pexo-billing-confirm.sh <project_id> <confirmation_id> --user-approved
Step 5に戻る。
ユーザーが代わりにリクエストを変更した場合:
実行: pexo-chat.sh <project_id> "{ユーザーの正確な修正リクエスト}"
これにより、新しいメッセージを送信する前に保留中の確認がキャンセルされます。
Step 5に戻る。
"RESPOND" →
recentMessages配列を読み取ります。すべてのイベントを処理します:
イベント「message」（Pexoがテキストを送信）:
Pexoのテキストをユーザーに完全に中継します。
Pexoが質問した場合、ユーザーの回答を待ちます。
その後、実行: pexo-chat.sh <project_id> "{ユーザーの正確な回答}"
Step 5に戻る。
イベント「preview_video」（Pexoがプレビューオプションを送信）:
各assetIdに対して:
実行: pexo-asset-get.sh <project_id> <assetId>
返されたJSONから「url」フィールドをコピーします。
すべてのプレビューURLをラベル（A、B、C...）とともにユーザーに表示します。
ユーザーに1つ選んでもらいます。
ユーザーが選択した後:
実行: pexo-chat.sh <project_id> "{ユーザーの選択}" --choice <selected_asset_id>
Step 5に戻る。
イベント「document」:
そのドキュメントについてユーザーに伝えます。
イベント「attachment」:
pexo-asset-get.shで各assetIdを取得し、結果のファイルまたはURLを配信します。
"DELIVER" →
Step 7に進む。
"FAILED" →
Step 8に進む。
"RECONNECT" →
実行: pexo-chat.sh <project_id> "continue"
接続が中断されたため再接続していることをユーザーに伝えます。
Step 5に戻る。
Step 7. 最終動画を配信する。
7a. recentMessages内のメッセージイベントを中継し、final_video
イベントを見つけてそのassetIdを取得します。
7b. ユーザーのリクエストからダウンロードバリアントを決定します:
- デフォルト: 透かしなしでダウンロード。
- ユーザーが明示的に透かしを保持、表示、または追加するよう要求した場合は、
透かし付きバリアントを使用します。
- どちらのバリアントも、アクティブなサブスクリプションまたは透かしホワイトリストが必要です。
7c. 次のいずれかを実行します:
- pexo-asset-get.sh <project_id> <assetId>
（デフォルト、透かしなし）
- pexo-asset-get.sh <project_id> <assetId> --with-watermark
（明示的にリクエストされた場合のみ）
7d. ダウンロードした動画ファイルをユーザーに表示します。
7e. また、次の内容を含むメッセージを（ユーザーの言語で）送信します:
- 動画のダウンロードURL（JSON出力の「url」フィールドをコピー）。
すべてのクエリパラメータを含む完全なURLをプレーンテキストで送信します。
例:
https://pexo-assets.oss-us-east-1.aliyuncs.com/projects%2F123%2Fassets%2Fvideo.mp4?OSSAccessKeyId=xxx&Expires=xxx&Signature=xxx
- プロジェクトページ: https://pexo.ai/project/{project_id}
- 満足しているか、修正が必要か尋ねます。
避けるべき一般的な配信ミス:
✗ URLの切り捨て（?OSSAccessKeyId=...&Signature=...が欠落）→ 403 Forbidden
✗ マークダウンで[text](url)にラップ → 一部のプラットフォームでURLが壊れる
Step 8. 障害を処理する。
8a. JSONからfailureReason、nextActionHint、recentMessagesを読み取ります。
8b. failureReasonが「INSUFFICIENT_CREDITS」の場合:
アカウントのクレジットが不足しているため、
プロダクションが停止したことをユーザーに明確に伝えます。
以下のクレジットエラー処理に移動します。ユーザーがクレジットを追加したことを
確認するまで、再試行を提案したり試みたりしないでください。
そうでなく、失敗したコマンドのstderrに「Credits balance」、
「credits」、「Insufficient credits」が含まれている場合:
以下のクレジットエラー処理に移動します。
そうでない場合、次の内容を含むメッセージを（ユーザーの言語で）送信します:
- 何が問題だったか（nextActionHintを簡単な言葉で説明）
- プロジェクトページ: https://pexo.ai/project/{project_id}
- 再試行を提案する。
Step 9. タイムアウト。
Step 5のループに30分以上いて、nextActionがまだ「WAIT」の場合:
次の内容を含むメッセージを（ユーザーの言語で）送信します:
- 動画の生成に予想以上に時間がかかっています。
- プロジェクトページ: https://pexo.ai/project/{project_id}
- ヘルプガイド: https://pexo.ai/connect/openclaw
- そのまま待つか、最初からやり直すかを尋ねます。
ポーリングを停止します。ユーザーの指示を待ちます。
クレジットエラー処理
pexo-project-get.shがfailureReason: "INSUFFICIENT_CREDITS"を返した場合、またはコマンドが失敗しstderrにクレジット関連の情報（「Credits balance」、「credits」、「Insufficient credits」を探す）が含まれている場合、このフローを使用します:
Step A. stderrに購入リンクと手順が含まれている場合、それらをユーザーに（ユーザーの言語で）送信します。
Step B. stderrに購入リンクなしでエラーメッセージのみが含まれている場合、次の内容を含むメッセージを（ユーザーの言語で）送信します:
- クレジットが不足しています。
- クレジットを追加するには: https://pexo.ai/home?billing=credits にアクセスし、購入フローを完了してください。
Step C. ユーザーがクレジットを追加したことを確認した後、失敗したステップを再試行します。
改訂
…
[翻訳のため省略]