用途:把用户的一句话想法交给 Pexo 托管的智能体,端到端生成完整视频,涵盖脚本撰写、镜头选择、模型调用、配乐与剪辑。使用者的角色是转达而非创作,不应自行添加用户未要求的时长、风格或模型,否则会覆盖 Pexo 的判断、影响成片效果。
配置:在 ~/.pexo/config 中写入 PEXO_BASE_URL(https://pexo.ai)与 PEXO_API_KEY(sk-<your-api-key>)。首次使用或没有账号时,按 SETUP-CHECKLIST.md 引导用户完成注册(含赠送新用户积分的邀请码)并创建上述配置;配置报错可运行 scripts/pexo-doctor.sh,按其输出处理。
主要流程:pexo-project-create.sh "<short brief>" 创建项目并保存 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> "<用户原话> <asset tags>" 原样转发用户请求。告知用户已提交、约需 15–20 分钟,并给出 https://pexo.ai/project/<project_id>。
轮询与交付:每 ≥60 秒运行 pexo-project-get.sh <project_id>,按 nextAction 处理。WAIT 继续轮询,约每 5 次发一条带项目链接的简报;RESPOND 处理 recentMessages 事件——文字转达并在对方提问时等待用户回答;preview_video 用 pexo-asset-get.sh 取各选项 URL(A/B/C)供用户选择,再用 pexo-chat.sh "<choice>" --choice <assetId> 提交;文档事件告知用户;DELIVER 用 pexo-asset-get.sh 取最终素材,把完整 URL(含全部 ? 查询参数,不截断、不用 markdown 包裹)与项目链接以纯文本发送;FAILED 用平实语言说明 nextActionHint 并询问是否重试;RECONNECT 发送 "continue" 并继续轮询。WAIT 期间切勿调用 pexo-chat.sh,否则会触发重复生成。超过 30 分钟仍 WAIT,应告知用户运行偏久(附项目链接和 https://pexo.ai/connect/openclaw),询问继续等待还是停止。
修改与积分:交付后用户的调整(缩短、换音乐、换镜头)应复用同一项目,用 pexo-chat.sh 发送反馈后再次轮询,不要新建项目,否则会丢失服务端上下文。若脚本报 Credits balance / Insufficient credits,有购买链接则转给用户,否则引导到 https://pexo.ai/home → Credits → Buy Credits,充值后重试。错误码与边界情况见 references/TROUBLESHOOTING.md。资料未提供定价、支持平台、视频规格等细节。