video-download-assist

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

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: 系统包管理器 (推荐)

bash

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

# macOS (Homebrew)
brew install yt-dlp

# Windows (Scoop)
scoop install yt-dlp

方法 2: 直接下载最新版

bash

# 下载二进制文件
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 安装

bash

pip install yt-dlp

🚀 快速使用

基础用法

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

text

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

手动调用脚本

bash

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

输出目录

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

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

📋 完整示例

示例 1: 下载 B 站视频

text

用户：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: 下载抖音视频

text

用户：帮我把这个抖音视频下载下来 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 视频

text

用户：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 视频已下载

🔧 高级配置

选择画质

bash

# 最高画质 (默认)
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>

批量下载

bash

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

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

下载字幕

bash

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

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

⚠️ 常见问题

Q: 提示 "Requested format is not available"

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

解决：

bash

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

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

Q: 下载速度慢

解决：

bash

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

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

Q: 需要登录才能下载

解决： 从浏览器导出 cookies

bash

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

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

Q: 视频文件名乱码

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

bash

# 检查 locale
locale

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

📁 文件结构

text

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。