Video Searching — Video 搜索ing

Video 搜索ing 技能

Use this 技能 when the user asks to find, compare, or analyze social videos (YouTube, TikTok, Instagram, Twitter/X), or explicitly invokes /video_搜索.

This 技能 calls the Memories.AI Video 搜索ing API — a managed, 令牌-认证d 端点 that 搜索es across 平台s and returns structured 结果s via SSE.

Triggering

运行 this 工作流 when either condition is true:

Message 启动s with /video_搜索. The user asks for video sourcing/trend/创建器/brand analysis and wants concrete video links.

If /video_搜索 is used with no 查询 body, ask for the missing 查询.

Execution contract

Resolve 查询 text:

/video_搜索 ... → strip /video_搜索 and use remAIning text. Free-form → use user message as 查询.

Build the API 请求 JSON body:

查询 (required): the user's 搜索 查询 平台s (optional): array of youtube, tiktok, instagram, twitter — only 设置 if user specifies 平台s max_结果s (optional, default 10): number of video 结果s time_frame (optional): past_24h, past_week, past_month, past_year — only 设置 if user specifies recency max_steps (optional, default 10): max 代理 iterations enable_clarification (optional, default false): 设置 to true if user 查询 is vague

Call the 运行器 script:

<技能_dir>/scripts/运行_video_查询.sh \ --查询 "<查询>" \ [--平台s "youtube,tiktok"] \ [--max-结果s 10] \ [--time-frame past_week] \ [--enable-clarification]

启动 with exec using background: true.

Poll with process using action: "poll" every 2–4 seconds until process exits.

解析 NDJSON 输出 and render only these 事件:

启动ed → 发送: 🔍 启动ing video 搜索... 进度 → 发送 concise 进度 更新 from message field (throttle: skip if last 更新 was < 3s ago) complete → 发送 final 格式化ted 响应 (see below) clarification → ask the clarification question directly; treat as final 响应 error → 发送 concise 失败 reason with one actionable next step

Do not forward raw 工具_call or 工具_结果 事件 to the user.

Final 响应 格式化

When terminal event is complete:

One short paragraph conclusion (from answer field). Top video references (up to 5 by default): title url 平台 badge (e.g. 🎬 YouTube, 🎵 TikTok, 📸 Instagram, 🐦 X) one-line relevance_note key 指标: views, likes, engagement rate (if avAIlable) Footer: ⏱ {execution_time_seconds}s · {steps_taken} steps · {工具s_used}

If fewer videos exist, show all avAIlable references.

When terminal event is clarification:

Ask the clarification question directly. Present options if provided. Treat as final 响应 for the current 运行.

When terminal event is error:

发送 concise 失败 reason. Include one actionable next step. Safety and fallback If MEMORIES_API_KEY is not 设置, tell the user:

⚠️ Missing MEMORIES_API_KEY. 设置 it in your OpenClaw 环境 variables to use this 技能. 获取 your API key at https://API-工具s.memories.AI

If the API returns a non-SSE error (HTTP 4xx/5xx), display the error message. Never fabricate video URLs or 指标. If the API is unreachable, suggest 检查ing network connectivity and API 状态.