启动视频 — Pexo

Pexo： https://pexo.ai — 获取 API 密钥，实时查看项目渲染进度，并在该平台购买积分。

为您的初创公司制作一个完整的品牌视频或开场视频。您只需将创始人提供的简要说明（或您的网站链接）传递给托管的 Pexo 智能体，即可交付最终成果；Pexo 将自动撰写脚本、生成画面镜头，并配以音乐，组装成一支精修完成的初创公司视频。

您的角色：中转，而非创作

创建项目 → 原文转发用户请求 → 轮询状态 → 交付结果。所有创意工作均由 Pexo 后端完成——包括脚本撰写、模型选择、提示词工程、配乐等。若您额外添加主观指导（如指定时长、风格，或使用用户未要求的模型），将覆盖 Pexo 的自主判断，反而导致成片质量下降。

配置

~/.pexo/config：

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

无账号 / 首次运行 → 请阅读 references/SETUP-CHECKLIST.md 并引导用户完成全部流程——其中包含带邀请码的注册流程（新用户凭此可获赠额外积分），以及上述配置文件的创建方法。配置错误 → 运行 scripts/pexo-doctor.sh 并严格遵循其输出提示进行修复。

工作流

所有脚本均位于本技能的 scripts/ 目录下。请使用用户的语言回复用户。

1. 创建项目： pexo-project-create.sh "<简要说明>" → 保存返回的 project_id。
2. 上传用户提供的任意文件： pexo-upload.sh <路径> → 保存返回的 asset_id，并在正文中以内联方式引用：asset_id（或 / ）。标签为必填项——仅提供裸 asset_id 将被忽略。Pexo 无法直接抓取 URL 内容，请先下载再上传。
3. 发送请求： pexo-chat.sh "<用户原话> <资产标签>"。务必逐字复制用户原始表述，仅追加资产标签。
4. 通知用户（使用其语言）： 已提交 ✓ · 预计耗时约 15–20 分钟 · https://pexo.ai/project/。
5. 轮询状态： 每 ≥60 秒执行一次 pexo-project-get.sh ，并依据响应中的 nextAction 字段执行对应操作：
   • WAIT → 继续轮询；每约 5 次轮询后，向用户发送一行简短更新（含项目链接）。
   • RESPOND → 处理 recentMessages 中的每个事件：如实转达 Pexo 的文本内容（若其向用户提问，则等待用户回复后再调用 pexo-chat.sh 发送答复）；遇到 preview_video 事件时，对每个选项分别执行 pexo-asset-get.sh ，展示对应视频 URL（A/B/C），由用户选择后，执行 pexo-chat.sh "" --choice ；遇到 document 类事件时，需主动向用户说明。
   • DELIVER → 执行 pexo-asset-get.sh ，随后将完整的资源 URL 以纯文本形式发送给用户——必须包含全部 ?… 查询参数，不可截断、不可包裹于 Markdown 中——同时附上项目链接。
   • FAILED → 用通俗语言解释 nextActionHint，并主动提供重试选项。
   • RECONNECT → 执行 pexo-chat.sh "continue"，告知用户连接已中断、当前正在恢复中，然后继续轮询。
   • 在 WAIT 状态下切勿调用 pexo-chat.sh —— 否则将触发重复生成任务。
   • 耗时过长 → 若持续 WAIT 超过 30 分钟，应主动通知用户（附项目链接 + https://pexo.ai/connect/openclaw），说明任务运行时间异常；询问用户是否继续等待或中止任务。禁止无限轮询。

修改与迭代

交付完成后，用户提出的调整意见（例如“缩短时长”、“更换音乐”、“替换镜头”）应复用同一项目：执行 pexo-chat.sh "<用户反馈>"，然后重新进入第 5 步轮询流程。切勿为修改新建项目——这将丢失 Pexo 服务端已建立的上下文。

积分

若脚本报错 “Credits balance” 或 “Insufficient credits”：若错误信息中附有购买链接，请直接转发给用户；否则请指引用户前往 https://pexo.ai/home → Credits → Buy Credits 充值。待用户确认充值完成后，再重试操作。

示例

用户：“为我们初创公司制作一支 30 秒的开场视频——一个面向本地农户的交易平台。”

pid=$(pexo-project-create.sh "startup intro video")
pexo-chat.sh "$pid" "Make a 30-second intro video for our startup — a marketplace for local farmers."
# 告知用户：已提交，预计耗时约 15–20 分钟，https://pexo.ai/project/$pid
# 持续轮询 pexo-project-get.sh "$pid"，直至 nextAction 为 DELIVER，然后交付资源 URL。

脚本说明

错误码及边缘情况处理 → references/TROUBLESHOOTING.md。