Download AIO Skill

Tải video, audio, playlist, subtitle, thumbnail từ 1000+ nền tảng bằng yt-dlp. Sau khi tải tự động gửi file về Telegram nếu dung lượng <= 50MB.

Cài đặt (chạy lần đầu)

Trước khi dùng, chạy script cài đặt để kiểm tra và cài đầy đủ dependencies:

powershell -ExecutionPolicy Bypass -File scripts/install.ps1

Script sẽ tự động:

1. Kiểm tra Python → hướng dẫn cài nếu thiếu
2. Cài yt-dlp
3. Kiểm tra ffmpeg → cài qua Chocolatey nếu thiếu
4. Tạo thư mục Downloads mặc định
5. Verify toàn bộ setup

Cách dùng (User Guide)

Cách đơn giản nhất

Chỉ cần paste URL vào chat là xong:

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

Agent sẽ tự tải về + gửi vào Telegram.

Tùy chỉnh nâng cao

Có thể yêu cầu cụ thể hơn:

• "Tải audio mp3 từ [URL]"
• "Tải playlist này, chỉ lấy 10 video đầu: [URL]"
• "Tải video 720p từ [URL]"
• "Tải phụ đề tiếng Việt từ [URL]"
• "Tải thumbnail từ [URL]"

Workflow

Step 1: Kiểm tra dependencies

Chạy scripts/check.ps1 để verify yt-dlp và ffmpeg có sẵn. Nếu thiếu, chạy scripts/install.ps1.

Step 2: Xác định yêu cầu

Thu thập từ user (nếu không có thì dùng default):

| Tham số | Default | Tùy chọn |

|---------|---------|-----------|

| URL | (bắt buộc) | - |

| Loại tải | video | video / audio / playlist / subtitle / thumbnail |

| Chất lượng | best | best / 1080p / 720p / 480p / 360p |

| Format | mp4 (video), mp3 (audio) | mp4 / webm / mkv / mp3 / m4a |

| Thư mục lưu | Downloads\yt-dlp\ | bất kỳ đường dẫn nào |

Step 3: Chạy lệnh tải

Xem references/commands.md để lấy lệnh đúng cho từng use case.

Lệnh cơ bản nhất (video best quality):

$PYTHON = scripts/find-python.ps1  # tự detect Python path
& $PYTHON -m yt_dlp `
  -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" `
  --merge-output-format mp4 `
  -o "$env:USERPROFILE\Downloads\yt-dlp\%(title)s.%(ext)s" `
  "<URL>"

Step 4: Gửi về Telegram (auto)

Sau khi tải xong:

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

• File <= 50MB:

1. Copy file vào workspace tạm: $env:USERPROFILE\.openclaw\workspace\tmp_send.
2. Dùng message tool: action=send, filePath=workspace path, caption="✅ {title} ({sizeMB}MB)"
3. Xóa file tạm sau khi gửi xong

• File > 50MB: Báo user "File {sizeMB}MB vượt giới hạn 50MB của Telegram. Đã lưu tại: {path}"

• Nếu lỗi khi gửi: thông báo lỗi + đường dẫn file trên máy

Nền tảng hỗ trợ

Xem references/platforms.md để biết danh sách đầy đủ và lưu ý riêng cho từng nền tảng.

Các nền tảng phổ biến: YouTube, TikTok, Facebook, Instagram, Twitter/X, Twitch, Vimeo, SoundCloud, Reddit, Bilibili, Dailymotion, Pinterest, LinkedIn...

Xử lý lỗi

Xem references/troubleshooting.md để xử lý các lỗi thường gặp:

• Lỗi cài đặt / không tìm thấy Python
• HTTP 429 (rate limit)
• Bot detection / cần đăng nhập
• ffmpeg not found
• File quá lớn

Lưu ý quan trọng

• Playlist > 50 video: hỏi user muốn tải bao nhiêu trước khi chạy
• Nội dung private (Instagram, Twitter): dùng --cookies-from-browser chrome
• Rate limit: thêm --sleep-interval 3 --max-sleep-interval 8
• Update yt-dlp thường xuyên: python -m pip install -U yt-dlp