Pexo AI Video Agent

Overview

Pexo is a professional AI video creation agent. You describe what you want, and Pexo handles everything — scriptwriting, shot composition, transitions, music, and final delivery. Output: 5–60 second videos in 16:9, 9:16 (vertical), or 1:1 aspect ratios.

Production time: ~15-20 minutes per short video.

First-Time Setup

Get Your API Key

1. Go to https://pexo.ai → Sign up/log in
2. Settings → API Keys → Generate new key
3. Copy the key (starts with sk-...)

Configure the Skill

Create file ~/.pexo/config:

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-your-key-here"

Or export environment variables:

export PEXO_BASE_URL="https://pexo.ai"
export PEXO_API_KEY="sk-your-key-here"

Language Rule

Reply in the SAME language the user uses. This is non-negotiable.

Workflow

Making a New Video

Step 1 — Create project

pexo-project-create.sh "Your video description here"

Save the returned project_id.

Step 2 — Upload files (optional)

pexo-upload.sh <project_id> /path/to/image.jpg

Save returned asset_id, wrap as asset_id.

Step 3 — Send request to Pexo

pexo-chat.sh <project_id> "{user's exact video request}"

> Copy the user's words exactly. Only add asset tags for uploaded files.

Step 4 — Notify user

• Confirm request submitted
• Estimated time: 15-20 minutes
• Project link: https://pexo.ai/project/{project_id}

Step 5 — Poll for status

pexo-project-get.sh <project_id>

Step 6 — Handle previews (Pexo may offer options)

pexo-asset-get.sh <project_id> <assetId>

Show preview URLs to user labeled A, B, C... Ask them to pick.

pexo-chat.sh <project_id> "{user's choice}" --choice <selected_asset_id>

Step 7 — Deliver final video

pexo-asset-get.sh <project_id> <assetId>

• Send the video URL as plain text (no markdown link)
• Include project page link
• Ask if satisfied or revisions needed

Step 8 — Handle failure

• Read nextActionHint
• Explain the issue to user simply
• Offer to retry or contact support

Revising an Existing Video

Reuse the same project_id and send feedback:

pexo-chat.sh <project_id> "{user's exact revision feedback}"

Then poll again (Step 5).

Script Reference

Pexo Capabilities

Pro Tips

• Be descriptive — include subject, setting, mood, camera angle, duration
• Upload reference images — helps Pexo match your brand aesthetic
• Use 9:16 vertical for TikTok, Reels, and Shorts
• Use 16:9 for YouTube ads and Facebook feed
• Consolidate feedback — one clear revision message is better than many small ones

Troubleshooting

For common errors and fixes, see: references/SETUP.md

Links

• Homepage: https://pexo.ai
• Setup Guide: https://pexo.ai/connect/openclaw
• GitHub: https://github.com/pexoai/pexo-skills