视频采集技能

当用户请求查找、对比或分析社交平台视频（YouTube、TikTok、Instagram、Twitter/X），或明确调用 /video_sourcing 时，使用该技能。

此工作流要求在宿主运行时执行（即关闭 sandbox 模式）。 当未设置 VIDEO_SOURCING_AGENT_ROOT 环境变量时，执行器将自动从 Memories-ai-labs/video-sourcing-agent@v0.2.5 引导一个固定版本的运行时环境。

触发条件

满足以下任一条件时，运行该工作流：

1. 消息以 /video_sourcing 开头。
2. 用户请求进行视频来源、趋势、创作者或品牌分析，并明确希望获得具体的视频链接。

若调用 /video_sourcing 但未提供查询内容，请主动询问缺失的查询语句。

执行契约

1. 解析查询文本：
   • /video_sourcing ... ⇒ 剥离 /video_sourcing 前缀，将其余文本作为查询内容。
   • 自由格式输入 ⇒ 直接使用用户消息全文作为查询内容。
2. 默认启用紧凑模式：
   • --event-detail compact
3. 若用户明确要求调试信息或原始载荷：
   • 切换至 --event-detail verbose

/video_sourcing 确定性执行路径

1. 构建带必需参数的命令：
   • /scripts/run_video_query.sh --query "" --event-detail --ux-mode three_message --progress-gate-seconds 5
2. 使用 exec 启动命令，设置 background: true 并显式指定超时：
   • timeout: 420
3. 以 2–4 秒为间隔，持续调用 process 并传入 action: "poll"，直至进程退出。
4. 解析 NDJSON 输出，并仅渲染以下事件；所有面向用户的文本均需使用你的 persona voice 表达：
   • started ⇒ 发送一条简短消息，表明视频采集已启动，语气需符合你的 persona voice
   • ux_progress ⇒ 解析 summary 字段中的结构化状态数据，用自然、简洁的语言生成进度更新（不可逐字复述 summary）；每条 ux_progress 事件均应作为独立的助手消息发送至 Telegram
   • 终态事件（complete、clarification_needed 或 error） ⇒ 原样发送最终消息
5. 禁止转发 /video_sourcing 的原始 progress、tool_call 或 tool_result 事件。
6. 在整个交互过程中（包括进度更新与最终响应），始终维持用户当前配置的 OpenClaw persona 行为风格。
7. 禁止在前一次运行会话仍处于活跃状态时，启动第二次运行。
   • 如需重试，请先对上一次运行的 sessionId 调用 process 并传入 action: "kill"。
8. 若进程在未发出终态事件的情况下提前退出，请发送一条简洁的兜底消息，该消息需：
   • 说明本次运行在完成前已终止，
   • 包含一项可立即执行的后续操作建议，
   • 不自动发起下一轮运行。

/video_sourcing 的行为目标：

1. 快速运行（<5 秒）：共发送 2 条消息（started + 终态事件）。
2. 较长运行（>=5 秒）：按节流策略周期性发送 ux_progress 更新，最后发送终态事件。

自由格式路径（非严格匹配）

1. 保持现有灵活的行为逻辑。
2. 构建命令时不强制启用 three_message 模式：
   • /scripts/run_video_query.sh --query "" --event-detail
3. 自然地流式输出有价值的进度更新与最终响应。

最终响应格式

当终态事件为 complete 时：

1. 一段简短结论性文字。
2. 默认仅展示排名前三的视频引用，每项包含：
   • title
   • url
   • 一行相关性说明
3. Tools used: ... —— 后接一份简洁的状态摘要。

若实际返回视频少于 3 个，则展示全部可用引用。

当终态事件为 clarification_needed 时：

1. 直接提出所需澄清的问题。
2. 将该问题视为当前运行的最终响应。

当终态事件为 error 时：

1. 发送简洁明了的失败原因。
2. 附带一项可立即执行的后续操作建议。

安全机制与兜底策略

1. 若脚本因缺少环境依赖或工具而失败，须明确指出缺失的具体组件（例如 VIDEO_SOURCING_AGENT_ROOT、uv 或某 API 密钥环境变量）。
2. 若未设置 VIDEO_SOURCING_AGENT_ROOT，执行器将使用托管路径：
   • ~/.openclaw/data/video-sourcing-agent/v0.2.5
3. VIDEO_SOURCING_AGENT_ROOT 保留为本地开发场景下的高级覆盖选项。
4. 响应内容须简洁、聚焦可执行动作。
5. 严禁虚构视频 URL 或任何指标数据。