Watch YouTube

How It Works

When to Use

• User shares a YouTube URL and wants a summary, transcript, or analysis
• User asks "what did they say about X in this video?"
• User wants timestamps of key moments
• User wants to compare multiple videos (up to 10 per request with Gemini 2.5+)

When NOT to Use

• Private or unlisted videos (only public videos work)
• User just wants the video link or metadata

Setup

GOOGLE_API_KEY

Usage

GOOGLE_API_KEY="$GOOGLE_API_KEY" python3 ~/.openclaw/workspace/skills/watch-youtube/watch.py "<youtube_url>" "<prompt>"

Examples

watch.py "https://www.youtube.com/watch?v=VIDEO_ID" "Summarize this video in 5 bullet points"

watch.py "https://www.youtube.com/watch?v=VIDEO_ID" "List the key moments with timestamps"

watch.py "https://www.youtube.com/watch?v=VIDEO_ID" "What tools or products did they mention?"

watch.py "https://www.youtube.com/watch?v=VIDEO_ID" "What happens at 05:30?" 

Limits

• Free tier: 8 hours of YouTube video per day
• Paid tier: No limit
• Max videos per request: 10 (Gemini 2.5+)
• Max video length: ~1 hour (1M context), ~3 hours (low res)
• ~300 tokens per second of video

Models

• gemini-2.5-flash

  — fast, cheap, good for most use cases

• gemini-2.5-pro

  — deeper analysis, longer videos

• gemini-3-flash-preview

  — latest, best quality