youtube-downloader

name	youtube-downloader
description	Download YouTube videos as MP4 at highest quality. Use when user sends a YouTube URL and wants to download/save it. Triggers on YouTube links (youtube.com, youtu.be) with download intent. Stores videos as assets with labels and registers them for the dashboard.

YouTube Downloader

Download YouTube videos as high-quality MP4 files and register them as assets.

Usage

When user sends a YouTube URL to download:

bash ~/. openclaw/workspace/skills/youtube-downloader/scripts/download.sh "YOUTUBE_URL" "label"

Parameters:

• YOUTUBE_URL - Full YouTube URL (youtube.com/watch, youtu.be, youtube.com/shorts)
• label - Short descriptive label (e.g., "honey-b-interview", "og-event-recap")

Example

User: "download this https://youtube.com/watch?v=abc123 and label it event-recap"

bash ~/.openclaw/workspace/skills/youtube-downloader/scripts/download.sh "https://youtube.com/watch?v=abc123" "event-recap"

Output

• Video location: ~/.openclaw/workspace/assets/videos/{label}_{videoId}_{timestamp}.mp4
• Registry: ~/.openclaw/workspace/assets/registry.json - JSON log of all downloaded assets

Registry Format

Each download adds an entry:

{
  "type": "video",
  "source": "youtube",
  "videoId": "abc123",
  "label": "event-recap",
  "filename": "event-recap_abc123_20260201_234500.mp4",
  "path": "/full/path/to/file.mp4",
  "url": "https://youtube.com/watch?v=abc123",
  "downloadedAt": "2026-02-01T23:45:00Z",
  "filesize": "150M"
}

Quality

Downloads best available quality:

• Video: Highest resolution (up to 4K)
• Audio: Best quality, merged
• Format: MP4 (h264 + aac)

Limitations

• No live streams
• Private/deleted videos will fail
• Age-restricted may need cookies