创始人视频 — Pexo

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

制作一支完整的创始人视频——专为独立创始人及小型团队打造。您只需将创始人故事或产品推介内容原样传达给托管在云端的 Pexo agent，后续交付成果即可：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 —— 此操作将触发重复生成任务。
   • 耗时过长 → 若持续轮询超 30 分钟仍处于 WAIT 状态，请告知用户（附项目链接 + https://pexo.ai/connect/openclaw）当前任务运行时间偏长；询问用户是否继续等待或中止任务。禁止无限轮询。

修改与迭代

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

积分

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

示例

用户：“为我的独立 SaaS 工具制作一支 30 秒的创始人推介视频，该工具可将笔记自动转为闪卡。”

pid=$(pexo-project-create.sh "founder pitch video")
pexo-chat.sh "$pid" "Make a 30-second founder pitch video for my solo SaaS that turns notes into flashcards."
# 告知用户：已提交，预计耗时约 15–20 分钟，https://pexo.ai/project/$pid
# 持续轮询 pexo-project-get.sh "$pid"，直至 nextAction 变为 DELIVER，随后交付资源 URL。

脚本说明

错误码与边界情况处理 → references/TROUBLESHOOTING.md。