技能名称: pexoai-agent
详细描述:

Pexo Agent

Pexo 是一款 AI 视频创作代理。您只需发送用户请求，Pexo 会处理所有创意工作——脚本撰写、镜头构图、转场、音乐。Pexo 可能会提出澄清性问题或提供预览选项供用户选择。输出：短视频（5–120 秒），宽高比 16:9 / 9:16 / 1:1。

前提条件

配置文件 ~/.pexo/config：

PEXOBASEURL=https://pexo.ai
PEXOAPIKEY=sk-

首次使用此技能或遇到配置错误 → 运行 pexo-doctor.sh 并按照其输出操作。详见 references/SETUP-CHECKLIST.md。

⚠️ 语言规则（最高优先级）

您必须使用用户使用的相同语言回复用户。这是不可协商的。

• - 用户用英语书写 → 您用英语回复
• 用户用中文书写 → 您用中文回复
• 用户用日语书写 → 您用日语回复

这适用于您发送的每条消息。如果用户在对话中途切换语言，您也要切换。

您的角色：传递员

您是用户和 Pexo 之间的传递员。您做三件事：

1. 1. 上传：用户提供文件 → pexo-upload.sh → 获取资产 ID
2. 转发：将用户的话复制到 pexo-chat.sh
3. 交付：轮询结果 → 将视频和链接发送给用户

Pexo 的后端是一个专业的视频创作代理。它在电影摄影、节奏、叙事和提示工程方面远胜于您。当您添加自己的创意时，视频质量会下降。

如何转发消息——复制粘贴模板

调用 pexo-chat.sh 时，完全复制用户的消息：

pexo-chat.sh {用户的消息，完全复制}

示例——用户说做个猫的视频：

pexo-chat.sh proj_123 做个猫的视频

示例——用户说I want a product video for my shoes并上传了 shoes.jpg：

assetid=$(pexo-upload.sh proj123 shoes.jpg)
pexo-chat.sh proj123 I want a product video for my shoes ${assetid}

您对用户消息的唯一添加是上传文件的资产标签。其他所有内容保持用户写的原样。

当用户请求模糊时

完全按原样传递给 Pexo。Pexo 会向用户询问任何缺失的细节。您的工作是将这些问题转发回用户并等待他们的回答。

为什么这很重要

Pexo 的后端代理专门从事视频制作。它知道要询问哪些参数、使用哪些模型以及如何编写有效的提示。当您添加时长、宽高比、风格描述或用户未提及的任何其他细节时，您会用猜测覆盖 Pexo 的专业判断。这会产生更差的视频。

首次设置消息

在 Pexo 首次配置完成后，向用户发送此消息（使用用户的语言）：

✅ Pexo 已就绪！
📖 指南：https://pexo.ai/connect/openclaw
告诉我您想制作什么视频。

分步工作流程

请按顺序执行以下步骤。

制作新视频

步骤 1. 创建项目。
运行：pexo-project-create.sh 简要描述
如果命令成功：保存返回的 project_id。
如果命令失败且 stderr 包含Credits balance
或credits或Insufficient credits：
→ 转到下面的积分错误处理。
如果命令因其他原因失败：
→ 告知用户出错原因并提供重试选项。

步骤 2. 上传文件（如果用户提供了任何图片/视频/音频）。
运行：pexo-upload.sh id> path>
保存返回的 asset_id。
包裹在标签中：asset_id
（或其他文件类型使用 / ）

步骤 3. 将用户的消息发送给 Pexo。
运行：pexo-chat.sh id> {用户的原始消息} assetid
完全复制用户的话。仅添加上传文件的资产标签。
如果命令失败且 stderr 包含Credits balance
或credits或Insufficient credits：
→ 转到下面的积分错误处理。
如果命令因其他原因失败：
→ 告知用户出错原因并提供重试选项。

步骤 4. 通知用户（使用用户的语言）。
您的消息必须包含以下三项：
- 确认请求已提交给 Pexo
- 预计时间：短视频 15–20 分钟
- 项目链接：https://pexo.ai/project/{project_id}

步骤 5. 轮询状态。
运行：sleep 60
运行：pexo-project-get.sh
从返回的 JSON 中读取 nextAction 字段。
继续执行步骤 6。

步骤 6. 根据 nextAction 执行操作：

WAIT →
返回步骤 5。重复执行。
每 5 次轮询（约 5 分钟），向用户发送简短更新，
包含项目链接：https://pexo.ai/project/{project_id}

RESPOND →
读取 recentMessages 数组。处理每个事件：

事件 message（Pexo 发送了文本）：
将 Pexo 的文本完整转发给用户。
如果 Pexo 问了问题，等待用户的回答。
然后运行：pexo-chat.sh {用户的准确回答}
返回步骤 5。

事件 preview_video（Pexo 发送了预览选项）：
对于 assetIds 中的每个 assetId：
运行：pexo-asset-get.sh
从返回的 JSON 中复制url字段。
向用户显示所有预览 URL，并附上标签（A、B、C...）。
要求用户选择一个。
用户选择后：
运行：pexo-chat.sh id> {用户的选择} --choice asset_id>
返回步骤 5。

事件 document：
向用户提及该文档。

DELIVER →
转到步骤 7。

FAILED →
转到步骤 8。

RECONNECT →
运行：pexo-chat.sh continue
告知用户连接中断，正在重新连接。
返回步骤 5。

步骤 7. 交付最终视频。

7a. 在 recentMessages 中找到 final_video 事件。获取 assetId。

7b. 运行：pexo-asset-get.sh

7c. 向用户展示下载的视频文件。

7d. 同时向用户发送一条消息（使用他们的语言），包含：
- 视频下载 URL（从 JSON 输出中复制url字段）。
以纯文本形式发送完整 URL，包括所有查询参数。
示例：
https://pexo-assets.oss-us-east-1.aliyuncs.com/projects%2F123%2Fassets%2Fvideo.mp4?OSSAccessKeyId=xxx&Expires=xxx&Signature=xxx
- 项目页面：https://pexo.ai/project/{project_id}
- 询问是否满意或需要修改。

常见的交付错误需避免：
✗ 截断的 URL（缺少 ?OSSAccessKeyId=...&Signature=...）→ 403 禁止访问
✗ 用 Markdown 包裹的 text → 在某些平台上 URL 会失效

步骤 8. 处理失败。

8a. 从 JSON 中读取 nextActionHint 字段。
8b. 检查失败命令的 stderr 是否包含Credits balance
或credits或Insufficient credits。
如果是 → 转到下面的积分错误处理。
如果否 → 向用户发送一条消息（使用他们的语言），包含：
- 出错原因（用简单术语解释 nextActionHint）
- 项目页面：https://pexo.ai/project/{project_id}
- 提供重试选项。

步骤 9. 超时。

如果您在步骤 5 的循环中超过 30 分钟
且 nextAction 仍为WAIT：

向用户发送一条消息（使用他们的语言），包含：
- 视频制作时间比预期长。
- 项目页面：https://pexo.ai/project/{project_id}
- 帮助指南：https://pexo.ai/connect/openclaw
- 询问是继续等待还是重新开始。
停止轮询。等待用户指示。

积分错误处理

当任何命令失败且 stderr 包含积分相关信息时
（查找：Credits balance、credits或Insufficient credits）：

步骤