| name | media-downloader |
| description | Download images and videos from any webpage and save to WebDAV. Supports Twitter/X, YouTube, Instagram, TikTok. Features concurrent downloads, deduplication, and resume support. |
| version | 3.2.0 |
| metadata | {"openclaw":{"requires":{"bins":["curl","python3","yt-dlp"],"env":["WEBDAV_URL","WEBDAV_USER","WEBDAV_PASSWORD"]},"primaryEnv":"WEBDAV_URL","emoji":"📥"}} |
Media Downloader v3.0
从任意网页下载图片和视频，通过 WebDAV 保存到目标服务器。
✨ v3.0 新特性
| 功能 | 说明 |
|---|
| 🎬 YouTube 支持 | yt-dlp 支持 YouTube/Instagram/TikTok |
| ⚡ 并发下载 | 多线程加速，默认 3 个 worker |
| 🔄 断点续传 | 大文件中断后可继续 |
| 🚫 自动去重 | 跳过已下载的文件 |
| 📊 历史记录 | 记录所有下载历史 |
使用方法
1. Twitter/X 自动下载
python3 scripts/media-downloader.py \
--url "https://x.com/user/status/123456" \
--output "/openclaw/downloads/"
自动功能：
- 提取推文所有图片/视频
- 按
@用户名/tweet_id/ 组织目录
2. YouTube/Instagram/TikTok
python3 scripts/media-downloader.py \
--url "https://www.youtube.com/watch?v=xxx" \
--output "/openclaw/youtube/"
python3 scripts/media-downloader.py \
--url "https://www.instagram.com/reel/xxx" \
--output "/openclaw/instagram/"
python3 scripts/media-downloader.py \
--url "https://www.tiktok.com/@user/video/xxx" \
--output "/openclaw/tiktok/"
3. 批量下载（并发）
python3 scripts/media-downloader.py \
--urls "url1,url2,url3" \
--output "/openclaw/downloads/" \
--workers 5
4. 去重控制
python3 scripts/media-downloader.py --url "xxx" --output "/openclaw/"
python3 scripts/media-downloader.py --url "xxx" --output "/openclaw/" --no-skip-dup
参数说明
| 参数 | 默认值 | 说明 |
|---|
--url | - | 单个 URL（支持 Twitter/YouTube/Instagram/TikTok/Douyin） |
--urls | - | 逗号分隔的 URL 列表（批量下载） |
--output | - | WebDAV 目标目录（必需） |
--filename | - | 自定义文件名（可选） |
--workers | 3 | 并发下载数（批量模式） |
--max-size | 100 | 最大文件大小 (MB) |
--timeout | 60 | 下载超时 (秒) |
--skip-dup | True | 跳过重复文件（默认） |
--no-skip-dup | - | 强制重新下载 |
--no-watermark | True | 去除水印（Douyin，默认开启） |
--keep-watermark | - | 保留水印（Douyin） |
--cookies | - | Cookie 文件（Douyin/TikTok，可选） |
--json | - | JSON 格式输出 |
--quiet | - | 静默模式 |
--debug | - | 调试模式 |
支持的平台
| 平台 | 方式 | 说明 |
|---|
| Twitter/X | fxtwitter API | 图片+视频 |
| YouTube | yt-dlp | 视频 |
| Instagram | yt-dlp | 图片+视频 |
| TikTok | yt-dlp | 视频 |
| 其他网页 | HTML 解析 | 图片 |
去重机制
- URL 去重 - 记录已下载的 URL
- 文件哈希 - MD5 检测重复内容
- 历史文件 -
~/.openclaw/media_downloader_history.json
配置
在 ~/.openclaw/openclaw.json 中：
{
"agents": {
"defaults": {
"env": {
"WEBDAV_URL": "http://192.168.11.147:5005",
"WEBDAV_USER": "username",
"WEBDAV_PASSWORD": "password"
}
}
}
}
依赖
- Python 3
- requests
- yt-dlp（YouTube/Instagram/TikTok）
安装 yt-dlp：
pip3 install --break-system-packages yt-dlp
