video-download-assist

v1.0.0

自动下载保存用户提供的 B 站、抖音、TikTok、YouTube 等平台视频，支持无水印和高画质选项。

⭐ 1· 333·0 current·0 all-time

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for zhangxiangyu8516/video-download-assist.

Previewing Install & Setup.

Prompt PreviewInstall & Setup

Install the skill "video-download-assist" (zhangxiangyu8516/video-download-assist) from ClawHub.
Skill page: https://clawhub.ai/zhangxiangyu8516/video-download-assist
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install video-download-assist

ClawHub CLI

Package manager switcher

npx clawhub@latest install video-download-assist

Security Scan

VirusTotal

Benign

View report →

OpenClaw

Benign

high confidence

✓

Purpose & Capability

技能名称与说明（下载 B 站/抖音/TikTok/YouTube 视频）与脚本和文档一致。脚本使用 yt-dlp 调用子进程下载，文档也指导如何安装 yt-dlp；这些都是为实现宣称功能所需或可理解的依赖。

ℹ

Instruction Scope

SKILL.md 明确说明在用户提供视频链接时下载并保存到 ~/.openclaw/workspace/downloads/，脚本也仅处理传入 URL 并调用 yt-dlp。需注意文档建议使用 --cookies-from-browser 来处理需要登录的视频：这涉及读取本地浏览器 cookie（敏感数据），应仅在用户明确授权并了解风险时使用。

✓

Install Mechanism

没有 install spec（instruction-only + 一个辅助脚本），文档推荐通过系统包管理器、pip 或从 GitHub releases 下载 yt-dlp —— 这些都是常见且可追踪的来源（GitHub releases 是合理的来源）。没有可疑短链接或私人服务器下载。

ℹ

Credentials

技能不请求环境变量或凭据，脚本也没有尝试读取系统范围的配置或凭证。唯一需要注意的点是文档/用法建议可能会让用户导出或由 yt-dlp 读取浏览器 cookies（这是对本机敏感数据的访问，需用户主动执行）。

✓

Persistence & Privilege

技能不设置 always:true，不会强制常驻或修改其他技能配置。写入仅限于其工作目录下的下载目录 (~/.openclaw/workspace/downloads/)；没有提升系统权限或全局更改的行为。

Assessment

这是一个用途明确、实现直接的下载工具，但在安装/使用前请注意： - 只在确实获得权利或用户明确允许的情况下下载受版权保护的视频。遵守目标平台和当地法律。 - yt-dlp 是实际执行网络请求的程序，确保从可信来源安装并保持更新（优先使用包管理器或 GitHub releases）。 - 避免在未完全理解风险时使用 --cookies-from-browser 或向 yt-dlp 提供 cookies 文件，因为这会暴露本地浏览器登录信息；仅在你信任该环境且愿意提供时使用。 - 虽然当前脚本未从远端拉入/执行额外代码，但如果未来 SKILL.md 或脚本开始自动下载并执行第三方脚本（例如引用 Douyin_TikTok_Download_API 的远端二进制），那会增加风险——在那种情况下应重新评估。

Like a lobster shell, security has layers — review code before you run it.

latestvk97ddm18sfpc9ss99kyt3dbmw983ng7e

333downloads

1stars

1versions

Updated 1mo ago

v1.0.0

MIT-0

Video Downloader - 视频下载器

一键下载全网主流平台视频，自动保存到本地。基于 yt-dlp 构建，支持 1800+ 视频网站。

🎯 支持平台

平台	域名示例	备注
Bilibili	bilibili.com, b23.tv	支持 4K、弹幕 (需额外配置)
抖音	douyin.com, iesdouyin.com	支持无水印下载
TikTok	tiktok.com	支持无水印下载
YouTube	youtube.com, youtu.be	支持 8K、HDR、60fps
其他	1800+ 网站	完整列表见 yt-dlp 文档

📦 安装依赖

方法 1: 系统包管理器 (推荐)

# Ubuntu/Debian
sudo apt-get install yt-dlp

# macOS (Homebrew)
brew install yt-dlp

# Windows (Scoop)
scoop install yt-dlp

方法 2: 直接下载最新版

# 下载二进制文件
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlp

# 验证安装
yt-dlp --version

方法 3: pip 安装

pip install yt-dlp

🚀 快速使用

基础用法

用户发送视频链接，自动下载：

用户：https://www.bilibili.com/video/BV1xx411c7mD
助手：[自动下载并返回文件路径]

手动调用脚本

python ~/.openclaw/workspace/skills/video-downloader/scripts/download_video.py <视频链接>

输出目录

视频默认保存到：~/.openclaw/workspace/downloads/

文件名格式：平台名_视频标题.mp4

📋 完整示例

示例 1: 下载 B 站视频

用户：https://www.bilibili.com/video/BV1mjAYzhEYg/

执行：
~/.local/bin/yt-dlp -o "~/.openclaw/workspace/downloads/%(extractor)s_%(title)s.%(ext)s" https://www.bilibili.com/video/BV1mjAYzhEYg/

返回：
✅ 下载完成！
文件：/home/zxy/.openclaw/workspace/downloads/BiliBili_视频标题.mp4
大小：31MB

示例 2: 下载抖音视频

用户：帮我把这个抖音视频下载下来 https://v.douyin.com/xxxxx

执行：
~/.local/bin/yt-dlp -o "~/.openclaw/workspace/downloads/%(extractor)s_%(title)s.%(ext)s" https://v.douyin.com/xxxxx

返回：
✅ 抖音视频已下载
文件路径：~/.openclaw/workspace/downloads/Douyin_视频标题.mp4

示例 3: 下载 YouTube 视频

用户：https://www.youtube.com/watch?v=xxxxx

执行：
~/.local/bin/yt-dlp -o "~/.openclaw/workspace/downloads/%(extractor)s_%(title)s.%(ext)s" https://www.youtube.com/watch?v=xxxxx

返回：
✅ YouTube 视频已下载

🔧 高级配置

选择画质

# 最高画质 (默认)
yt-dlp <URL>

# 限制为 1080p
yt-dlp -f "best[height<=1080]" <URL>

# 限制为 720p (节省空间)
yt-dlp -f "best[height<=720]" <URL>

# 只下载音频 (转 MP3)
yt-dlp -x --audio-format mp3 <URL>

批量下载

# 下载整个播放列表
yt-dlp -o "~/.openclaw/workspace/downloads/%(playlist)s/%(title)s.%(ext)s" <播放列表链接>

# 下载频道所有视频
yt-dlp -o "~/.openclaw/workspace/downloads/%(uploader)s/%(title)s.%(ext)s" <频道链接>

下载字幕

# 自动下载字幕
yt-dlp --write-sub --sub-lang zh-Hans <URL>

# 嵌入字幕到视频
yt-dlp --embed-subs <URL>

⚠️ 常见问题

Q: 提示 "Requested format is not available"

原因： 某些视频需要大会员才能下载高画质

解决：

# 降低画质要求
yt-dlp -f "best[height<=720]" <URL>

# 或使用默认格式
yt-dlp <URL>

Q: 下载速度慢

解决：

# 限制并发连接数
yt-dlp --concurrent-fragments 4 <URL>

# 使用代理 (如果需要)
yt-dlp --proxy http://proxy:port <URL>

Q: 需要登录才能下载

解决： 从浏览器导出 cookies

# 从 Chrome 导出 cookies
yt-dlp --cookies-from-browser chrome <URL>

# 或使用 cookies 文件
yt-dlp --cookies cookies.txt <URL>

Q: 视频文件名乱码

解决： 脚本已处理中文编码，确保系统 locale 支持 UTF-8

# 检查 locale
locale

# 如需要，设置 UTF-8
export LANG=en_US.UTF-8

📁 文件结构

video-downloader/
├── SKILL.md              # 技能说明文件
├── scripts/
│   └── download_video.py # 下载脚本 (可选，直接用 yt-dlp 更简单)
├── references/
│   └── README.md         # 详细安装和使用指南
└── README.md             # 快速入门指南

🔐 安全说明

仅下载用户明确请求的视频
尊重版权，不要传播受保护内容
部分平台可能有下载限制，请遵守平台规则

📝 更新日志

v1.0.0 - 初始版本
- 支持 Bilibili、抖音、TikTok、YouTube
- 自动检测平台并下载
- 中文文件名支持
- 默认 1080p 画质

🙏 致谢

核心依赖：

yt-dlp - 152k+ stars 的万能下载器
Douyin_TikTok_Download_API - 抖音/TikTok 专用 API

📄 许可证

本 Skill 遵循 MIT 许可证。yt-dlp 遵循 Unlicense。

Comments

Loading comments...