Video Downloader#

Download videos from YouTube, TikTok, Instagram, Twitter/X, and 1000+ sites. Just paste a link — the video gets downloaded at full quality and sent back to you.

URL Detection (AUTO-TRIGGER)#

CRITICAL: When the user sends a message that contains a URL from any of these domains, AUTOMATICALLY treat it as a download request. Do NOT ask "what do you want me to do with this?" — just download it.

Auto-detect domains:

• youtube.com, youtu.be, m.youtube.com
• tiktok.com, vm.tiktok.com
• instagram.com (reels, posts, stories)
• x.com, twitter.com
• reddit.com (video posts)
• twitch.tv (clips)
• vimeo.com
• facebook.com (videos, reels)

Pattern: If user message contains a URL matching these domains → skip questions, download immediately.

Download Flow#

Step 1 — Download#

bash

yt-dlp --js-runtimes nodejs \
  -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" \
  --merge-output-format mp4 \
  --no-playlist \
  --output "/home/rami/.openclaw/workspace/_incoming/%(title).50s.%(ext)s" \
  "<URL>"

Fallback for stubborn sites (TikTok, Instagram):

bash

yt-dlp --js-runtimes nodejs \
  -f "best" \
  --no-playlist \
  --output "/home/rami/.openclaw/workspace/_incoming/%(title).50s.%(ext)s" \
  "<URL>"

Step 2 — Strip metadata#

Remove ALL metadata (title, author, GPS, comments, timestamps, source URL) for clean clips:

bash

ffmpeg -i "/home/rami/.openclaw/workspace/_incoming/<filename>" \
  -map_metadata -1 \
  -fflags +bitexact \
  -flags:v +bitexact \
  -flags:a +bitexact \
  -c copy \
  "/home/rami/.openclaw/workspace/_incoming/<filename>_clean.mp4" \
  && mv "/home/rami/.openclaw/workspace/_incoming/<filename>_clean.mp4" \
        "/home/rami/.openclaw/workspace/_incoming/<filename>"

This strips: title, artist, comment, description, source URL, creation date, encoder info, GPS coordinates — everything.

Step 3 — Get file info#

bash

ls -lh /home/rami/.openclaw/workspace/_incoming/<filename>

Step 3 — Send to user#

If file is under 50MB — send directly via Telegram:

bash

openclaw message send \
  --channel telegram \
  --target <user_id> \
  --message "🎬 Downloaded: <title>" \
  --media /home/rami/.openclaw/workspace/_incoming/<filename>

If file is over 50MB — use LocalSend:

1. Notify user: "Video is — too big for Telegram. Sending via LocalSend."

2. Start LocalSend send flow: bash

   localsend-cli send --to "<user_device>" /home/rami/.openclaw/workspace/_incoming/<filename>
   
   

Buttons after send:

json

buttons: [
  [
    { "text": "🎬 Download Another", "callback_data": "dl:another" },
    { "text": "📱 Send via LocalSend", "callback_data": "dl:localsend" }
  ],
  [
    { "text": "🗑️ Delete File", "callback_data": "dl:delete" }
  ]
]

Step 4 — Cleanup#

After confirmed delivery, offer to delete the file to save disk space.

Quality Options#

Default is best quality MP4. If user asks for specific quality:

RequestFlag"1080p"-f "bestvideo[height<=1080]+bestaudio/best[height<=1080]""720p"-f "bestvideo[height<=720]+bestaudio/best[height<=720]""audio only" / "mp3"-x --audio-format mp3"thumbnail"--write-thumbnail --skip-download

Audio-Only Downloads#

If user says "mp3", "audio only", "just the audio":

bash

yt-dlp --js-runtimes nodejs \
  -x --audio-format mp3 \
  --output "/home/rami/.openclaw/workspace/_incoming/%(title).50s.%(ext)s" \
  "<URL>"

Batch Downloads (Playlists)#

If user sends a playlist URL and says "download all":

bash

yt-dlp --js-runtimes nodejs \
  -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" \
  --merge-output-format mp4 \
  --output "/home/rami/.openclaw/workspace/_incoming/%(title).50s.%(ext)s" \
  "<URL>"

Remove --no-playlist flag for playlists.

Error Handling#

ErrorFix"Video unavailable"Private/deleted video — notify user"Sign in to confirm"Age-restricted — try with --cookies-from-browser chromeGeographic restrictionTry with --geo-bypassRate limitedWait 30s and retry onceMerge failedFallback to -f best (single stream)

Callback Reference#

callback_dataActiondl:anotherPrompt for another URLdl:localsendSend last downloaded file via LocalSenddl:deleteDelete the downloaded filedl:audioRe-download as MP3

CLI Reference#

CommandUsageBest qualityyt-dlp -f "bestvideo+bestaudio/best" --merge-output-format mp4 URLAudio onlyyt-dlp -x --audio-format mp3 URLList formatsyt-dlp -F URLThumbnailyt-dlp --write-thumbnail --skip-download URL