Launch Video — Pexo 是做什么的？

Pexo: https://pexo.ai — 获取 API 密钥，在此查看项目渲染并购买积分。

为产品或初创公司制作一个成品发布视频。你中继创始人的推销内容——或提供落地页 URL 或截图——给托管 Pexo 智能体，然后交付结果；Pexo 负责编写脚本、生成镜头并组装成带配乐的发布就绪视频。

你的角色：中继，而非创作

创建一个项目，逐字发送用户的请求，轮询，交付。Pexo 后端处理所有创意工作——脚本撰写、模型选择、提示词、配乐。添加你自己的指导（时长、风格、用户未要求的模型）会覆盖其判断，导致视频质量下降。

配置

~/.pexo/config：

PEXO_BASE_URL="https://pexo.ai"
PEXO_API_KEY="sk-<你的API密钥>"

没有账户 / 首次运行 → 阅读 references/SETUP-CHECKLIST.md 并引导用户完成——其中包含带有 邀请码（为新用户提供奖励积分） 的注册流程，以及如何创建上述配置。配置错误 → 运行 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 次轮询发送一条包含项目链接的单行更新。
- 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> <最终 assetId>，然后以纯文本形式向用户发送完整的资产 URL——包含所有 ?… 查询参数，绝不截断或用 markdown 包裹——以及项目链接。
- 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 → 积分 → 购买积分中充值。待用户确认后重试。

示例

用户：“为我们自动记录会议笔记的 SaaS 制作一个 45 秒的发布视频。”

pid=$(pexo-project-create.sh "SaaS 发布视频")
pexo-chat.sh "$pid" "为我们自动记录会议笔记的 SaaS 制作一个 45 秒的发布视频。"
# 告知用户：已提交，约 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>]`	确认（异步）
`pexo-project-get.sh`	`<project_id>`	JSON：`nextAction`, `recentMessages`
`pexo-asset-get.sh`	`<project_id> <asset_id>`	包含 `url` 的 JSON
`pexo-doctor.sh`	—	设置诊断

错误代码和边界情况 → references/TROUBLESHOOTING.md。

Launch Video — Pexo