核心用法
YouTube Downloader 是一款命令行视频下载工具，用户仅需提供 YouTube 链接与自定义标签即可自动抓取最高画质（最高支持 4K）并封装为 MP4。系统会调用 download.sh 脚本，将文件保存至 ~/.openclaw/workspace/assets/videos/，同时在 registry.json 中记录完整的元数据（视频 ID、标签、时间戳、文件路径、原始 URL 等），便于后续通过 Dashboard 检索与复用。
显著优点
1. 画质无损：默认合并最佳视频流与音频流，输出 h264+aac 的通用 MP4，兼容所有播放器与剪辑软件。
2. 自动化归档：标签化命名 + JSON 注册表机制，实现素材的可追溯与批量管理，避免本地文件杂乱。
3. 灵活触发：支持标准 YouTube、短链 youtu.be 及 Shorts 链接，满足多场景需求。
4. 零配置：开箱即用，无需手动安装 yt-dlp 或 ffmpeg，脚本已集成依赖检查。
潜在缺点与局限性
- 内容限制：无法下载直播流、已删除或私享视频；年龄限制内容需手动导入浏览器 Cookie，操作门槛提升。
- 版权风险：下载受版权保护的内容（如音乐 MV、付费课程）可能违反 YouTube ToS 及当地法律，需用户自行甄别。
- 存储占用：4K 视频单文件可达数 GB，长期累积需配合本地 NAS 或云同步策略。
- 网络依赖：下载速度与稳定性取决于代理或本地带宽，大文件断点续传未在文档中明确说明。
适合人群
- 内容创作者（需要离线剪辑素材、建立个人 B-roll 库）
- 市场与运营人员（归档品牌活动录像、竞品分析视频）
- 学术研究者（保存讲座、公开课、访谈作为文献备份）
- 播客与翻译团队（提取音轨进行二次创作与字幕翻译）
常规风险
- 合规风险：YouTube 服务条款明确禁止未经授权的下载，频繁大量抓取可能导致账号受限或 IP 封禁。
- 隐私泄露：若使用个人 Cookie 绕过年龄限制，Cookie 文件可能包含敏感会话信息，需确保存储路径权限可控。
- 供应链风险：脚本依赖 yt-dlp 与 ffmpeg，若未校验签名可能引入恶意二进制；建议锁定版本并校验哈希。