WeChat Video Downloader

从微信公众号文章中提取并下载视频。使用场景：用户发送公众号文章链接并要求下载其中的视频，或提到"微信视频下载"、"公众号视频"、"mp.weixin.qq.com 视频"等关键词。自动识别页面中的视频播放器，提取真实视频 URL 并下载到本地。

Security Scan

The skill's code and instructions match its stated purpose (extracting and downloading videos from mp.weixin.qq.com articles); it requires only the OpenClaw browser CLI and curl and does not request unrelated credentials or perform hidden exfiltration.

Purpose & Capability

Name/description, SKILL.md, README, and the included Python script are all aligned: they open a WeChat article via the OpenClaw browser, locate a video element, extract the video URL, and download it with curl. No unrelated services, credentials, or binaries are requested.

Instruction Scope

Instructions tell the agent to open the article with OpenClaw browser, snapshot the page, click play, evaluate JS to read the <video> src, and use curl to download. These steps are within the skill's stated purpose. Note: the browser automation will run in the OpenClaw browser context and therefore may use any cookies/session state present there (so it can access content available to that session).

Install Mechanism

No external install or downloads are specified (instruction-only skill with a bundled script). The code is included in the skill package; nothing is fetched from third-party URLs or arbitrary hosts during install.

Credentials

The skill declares no required environment variables, credentials, or config paths. The runtime does call the system 'openclaw' CLI and 'curl', which are reasonable for browser automation and downloading and match the declared dependencies.

Persistence & Privilege

always is false and the skill does not request permanent/global privileges or modify other skills. It operates only when invoked and uses local browser automation; autonomous invocation is allowed but not unusual for skills.

Assessment

This skill appears to do exactly what it claims: automate the OpenClaw browser to extract a video URL and download it with curl. Before installing, consider: (1) legal/copyright implications — only download content you are allowed to; (2) it will open pages using the OpenClaw browser context and may access content available to any logged-in sessions/cookies there — clear sensitive sessions if needed; (3) downloaded files can be large — ensure disk space; (4) the script runs local subprocesses (openclaw, curl) — inspect the included Python file if you want to verify behavior. If you want extra caution, run the skill in an isolated environment or review the script source (it's included) before use.

微信视频下载器

从微信公众号文章中提取并下载嵌入的视频文件。

快速开始

当用户提供微信公众号文章链接时，使用内置脚本下载视频：

python ~/.openclaw/skills/wechat-video-downloader/scripts/download_wechat_video.py <文章 URL> [输出文件名]

工作流程

1. 识别触发场景

当用户请求包含以下特征时触发此技能：

• 包含 mp.weixin.qq.com 的 URL
• 提到"微信视频"、"公众号视频"、"下载视频"等关键词
• 发送公众号文章链接并要求获取其中的视频

2. 检查文章是否包含视频

方法 A：使用浏览器快照（推荐）

打开文章页面并获取快照，查找视频播放按钮：

1. 用 browser.open 打开文章 URL
2. 用 browser.snapshot 获取页面快照（refs="aria"）
3. 查找包含"播放视频"、"play"、"video"的 button 元素
4. 提取按钮的 ref 用于后续点击

方法 B：直接调用脚本

如果确认文章包含视频，直接运行下载脚本：

python ~/.openclaw/skills/wechat-video-downloader/scripts/download_wechat_video.py <URL>

3. 下载视频

脚本自动执行以下步骤：

1. 打开页面 - 使用 browser.open 加载文章
2. 查找视频 - 通过 snapshot 定位播放按钮
3. 触发加载 - 点击播放按钮使视频元素加载
4. 提取 URL - 通过 JavaScript 获取 <video> 元素的 src
5. 下载文件 - 使用 curl 添加正确的 User-Agent 和 Referer 请求头
6. 关闭页面 - 清理浏览器标签页

4. 处理常见问题

问题 1:403 Forbidden

微信视频链接有时效性和来源验证，必须添加正确的请求头：

curl -L -o output.mp4 \
  -H "User-Agent: Mozilla/5.0 ..." \
  -H "Referer: https://mp.weixin.qq.com/" \
  "<video_url>"

问题 2：找不到视频元素

• 确认文章确实包含视频（有些文章只有图片）
• 等待页面完全加载（增加 sleep 时间）
• 检查是否有多个视频，尝试不同的播放按钮 ref

问题 3：视频链接过期

视频 URL 包含时效性 token，必须在点击播放后立即提取并下载，不能重复使用旧链接。

脚本说明

位置

~/.openclaw/skills/wechat-video-downloader/scripts/download_wechat_video.py

参数

• article_url（必需）- 微信公众号文章 URL
• output_filename（可选）- 输出文件名，默认使用视频 ID

返回值

• 成功：返回 0，视频保存到当前目录
• 失败：返回 1，打印错误信息

依赖

• Python 3.6+
• OpenClaw CLI（browser 命令）
• curl

示例

示例 1：基本下载

用户：下载这个公众号文章里的视频 https://mp.weixin.qq.com/s/xxx

python ~/.openclaw/skills/wechat-video-downloader/scripts/download_wechat_video.py https://mp.weixin.qq.com/s/xxx

示例 2：指定文件名

用户：把视频保存为"教学视频.mp4"

python ~/.openclaw/skills/wechat-video-downloader/scripts/download_wechat_video.py https://mp.weixin.qq.com/s/xxx 教学视频.mp4

示例 3：手动流程（脚本失败时）

如果脚本无法自动处理，手动执行：

1. browser.open targetUrl=<文章 URL>
2. browser.snapshot refs="aria" → 找到播放按钮 ref
3. browser.act request='{"kind":"click","ref":"e88"}'
4. sleep 3
5. browser.act request='{"kind":"evaluate","fn":"()=>document.querySelector(\"video\").src"}'
6. 用 curl 下载提取的 URL
7. browser.close 关闭页面

注意事项

1. 视频时效性 - 提取的 URL 包含认证 token，必须在短时间内使用
2. 网络速度 - 视频文件通常较大（100MB-1GB），下载需要时间
3. 存储空间 - 确保工作目录有足够空间
4. 版权尊重 - 仅下载用于个人学习或已获授权的内容

支持的视频类型

• ✅ 微信公众号内置视频播放器（mpvideo.qpic.cn）
• ✅ 腾讯视频嵌入（v.qq.com）
• ⚠️ 第三方平台视频（可能需要额外处理）

故障排查

问题	可能原因	解决方案
403 Forbidden	缺少 Referer 头	确保 curl 添加 -H "Referer: https://mp.weixin.qq.com/"
找不到视频	页面未完全加载	增加点击前的等待时间
文件为空	URL 过期	重新打开页面，立即提取并下载
脚本无响应	浏览器未启动	先运行 openclaw browser start