下载 AIO Skill

使用 yt-dlp 从 1000+ 个平台下载视频、音频、播放列表、字幕和缩略图。下载完成后，若文件大小 ≤ 50MB，则自动将文件发送至 Telegram。

安装（首次运行）

使用前，请运行安装脚本以检查并安装所有依赖项：

powershell -ExecutionPolicy Bypass -File scripts/install.ps1

该脚本将自动执行以下操作：

1. 检查 Python → 若缺失则提供安装指引
2. 安装 yt-dlp
3. 检查 ffmpeg → 若缺失则通过 Chocolatey 安装
4. 创建默认 Downloads 目录
5. 验证全部配置是否就绪

使用方法（用户指南）

最简单的方式

只需将 URL 粘贴到聊天窗口中即可：

https://www.youtube.com/watch?v=...
https://www.tiktok.com/@user/video/...
https://www.facebook.com/reel/...

Agent 将自动完成下载，并将结果发送至 Telegram。

高级自定义选项

您可提出更具体的下载请求，例如：

• “从 [URL] 下载 MP3 音频”
• “下载该播放列表，仅取前 10 个视频：[URL]”
• “从 [URL] 下载 720p 视频”
• “从 [URL] 下载越南语字幕”
• “从 [URL] 下载缩略图”

工作流（Workflow）

步骤 1：检查依赖项

运行 scripts/check.ps1 以验证 yt-dlp 和 ffmpeg 是否已就绪。若缺失，请运行 scripts/install.ps1。

步骤 2：解析用户请求

从用户输入中提取参数（若未指定则使用默认值）：

步骤 3：执行下载命令

请查阅 references/commands.md 获取不同场景下的对应命令。

最基础的命令（下载最高画质视频）：

$PYTHON = scripts/find-python.ps1  # 自动探测 Python 路径
& $PYTHON -m yt_dlp `
  -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" `
  --merge-output-format mp4 `
  -o "$env:USERPROFILEDownloadsyt-dlp%(title)s.%(ext)s" `
  ""

步骤 4：自动发送至 Telegram

下载完成后执行以下逻辑：

$file = Get-ChildItem "$env:USERPROFILEDownloadsyt-dlp" | Sort-Object LastWriteTime -Descending | Select-Object -First 1
$sizeMB = [math]::Round($file.Length / 1MB, 2)

• 文件大小 ≤ 50MB：

  1. 将文件复制至临时 workspace 目录：$env:USERPROFILE.openclawworkspacetmp_send.
  2. 调用 message 工具：action=send，filePath=workspace 路径，caption="✅ {title} ({sizeMB}MB)"
  3. 发送成功后删除临时文件

• 文件大小 > 50MB：提示用户 “文件 {sizeMB}MB 超出 Telegram 的 50MB 限制。已保存至：{path}”

• 发送失败时：返回错误信息 + 本地文件路径

支持的平台

完整平台列表及各平台注意事项，请参阅 references/platforms.md。

主流平台包括：YouTube、TikTok、Facebook、Instagram、Twitter/X、Twitch、Vimeo、SoundCloud、Reddit、Bilibili、Dailymotion、Pinterest、LinkedIn…

常见问题排查

请查阅 references/troubleshooting.md 处理以下常见问题：

• 安装失败 / 找不到 Python
• HTTP 429（请求频率超限）
• 被平台识别为机器人 / 需要登录
• ffmpeg 未找到
• 文件过大

重要注意事项

• 播放列表包含超过 50 个视频时：运行前需向用户确认下载数量
• 私有内容（如 Instagram、Twitter）：使用 --cookies-from-browser chrome
• 应对限速（rate limit）：添加参数 --sleep-interval 3 --max-sleep-interval 8
• 定期更新 yt-dlp：python -m pip install -U yt-dlp