\r \r

Download AIO Skill\r

\r 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 \x3C= 50MB.\r \r

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

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

powershell -ExecutionPolicy Bypass -File scripts/install.ps1\r
```\r
\r
Script sẽ tự động:\r
1. Kiểm tra Python → hướng dẫn cài nếu thiếu\r
2. Cài yt-dlp\r
3. Kiểm tra ffmpeg → cài qua Chocolatey nếu thiếu\r
4. Tạo thư mục Downloads mặc định\r
5. Verify toàn bộ setup\r
\r
## Cách dùng (User Guide)\r
\r
### Cách đơn giản nhất\r
Chỉ cần paste URL vào chat là xong:\r
```\r
https://www.youtube.com/watch?v=...\r
https://www.tiktok.com/@user/video/...\r
https://www.facebook.com/reel/...\r
```\r
\r
Agent sẽ tự tải về + gửi vào Telegram.\r
\r
### Tùy chỉnh nâng cao\r
Có thể yêu cầu cụ thể hơn:\r
- "Tải audio mp3 từ [URL]"\r
- "Tải playlist này, chỉ lấy 10 video đầu: [URL]"\r
- "Tải video 720p từ [URL]"\r
- "Tải phụ đề tiếng Việt từ [URL]"\r
- "Tải thumbnail từ [URL]"\r
\r
## Workflow\r
\r
### Step 1: Kiểm tra dependencies\r
\r
Chạy scripts/check.ps1 để verify yt-dlp và ffmpeg có sẵn. Nếu thiếu, chạy scripts/install.ps1.\r
\r
### Step 2: Xác định yêu cầu\r
\r
Thu thập từ user (nếu không có thì dùng default):\r
\r
| Tham số | Default | Tùy chọn |\r
|---------|---------|-----------|\r
| URL | (bắt buộc) | - |\r
| Loại tải | video | video / audio / playlist / subtitle / thumbnail |\r
| Chất lượng | best | best / 1080p / 720p / 480p / 360p |\r
| Format | mp4 (video), mp3 (audio) | mp4 / webm / mkv / mp3 / m4a |\r
| Thư mục lưu | Downloads\yt-dlp\ | bất kỳ đường dẫn nào |\r
\r
### Step 3: Chạy lệnh tải\r
\r
Xem `references/commands.md` để lấy lệnh đúng cho từng use case.\r
\r
Lệnh cơ bản nhất (video best quality):\r
```powershell\r
$PYTHON = scripts/find-python.ps1  # tự detect Python path\r
& $PYTHON -m yt_dlp `\r
  -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" `\r
  --merge-output-format mp4 `\r
  -o "$env:USERPROFILE\Downloads\yt-dlp\%(title)s.%(ext)s" `\r
  "\x3CURL>"\r
```\r
\r
### Step 4: Gửi về Telegram (auto)\r
\r
Sau khi tải xong:\r
\r
```powershell\r
$file = Get-ChildItem "$env:USERPROFILE\Downloads\yt-dlp\" | Sort-Object LastWriteTime -Descending | Select-Object -First 1\r
$sizeMB = [math]::Round($file.Length / 1MB, 2)\r
```\r
\r
- File \x3C= 50MB:\r
  1. Copy file vào workspace tạm: `$env:USERPROFILE\.openclaw\workspace	mp_send.\x3Cext>`\r
  2. Dùng `message` tool: action=send, filePath=workspace path, caption="✅ {title} ({sizeMB}MB)"\r
  3. Xóa file tạm sau khi gửi xong\r
\r
- File > 50MB: Báo user "File {sizeMB}MB vượt giới hạn 50MB của Telegram. Đã lưu tại: {path}"\r
\r
- Nếu lỗi khi gửi: thông báo lỗi + đường dẫn file trên máy\r
\r
## Nền tảng hỗ trợ\r
\r
Xem `references/platforms.md` để biết danh sách đầy đủ và lưu ý riêng cho từng nền tảng.\r
\r
Các nền tảng phổ biến: YouTube, TikTok, Facebook, Instagram, Twitter/X, Twitch, Vimeo, SoundCloud, Reddit, Bilibili, Dailymotion, Pinterest, LinkedIn...\r
\r
## Xử lý lỗi\r
\r
Xem `references/troubleshooting.md` để xử lý các lỗi thường gặp:\r
- Lỗi cài đặt / không tìm thấy Python\r
- HTTP 429 (rate limit)\r
- Bot detection / cần đăng nhập\r
- ffmpeg not found\r
- File quá lớn\r
\r
## Lưu ý quan trọng\r
\r
- Playlist > 50 video: hỏi user muốn tải bao nhiêu trước khi chạy\r
- Nội dung private (Instagram, Twitter): dùng `--cookies-from-browser chrome`\r
- Rate limit: thêm `--sleep-interval 3 --max-sleep-interval 8`\r
- Update yt-dlp thường xuyên: `python -m pip install -U yt-dlp`\r