---

name: youtube-playlists description: Create and manage YouTube playlists. Use when user wants to create a playlist, add videos to playlists, or manage their YouTube playlists. metadata: {"openclaw":{"emoji":"📋","requires":{"bins":["python3"]}}}

YouTube Playlists

Create and manage YouTube playlists via OAuth.

Commands

# Authenticate (first time only)
python3 {baseDir}/scripts/yt_playlist.py auth

# Create empty playlist
python3 {baseDir}/scripts/yt_playlist.py create "Playlist Name"

# Add video to existing playlist  
python3 {baseDir}/scripts/yt_playlist.py add <playlist_id> <video_id_or_url>

# Create playlist with multiple videos (best for agent use)
python3 {baseDir}/scripts/yt_playlist.py bulk-create "Playlist Name" <video1> <video2> ...

# List your playlists
python3 {baseDir}/scripts/yt_playlist.py list

Examples

Create a Zwift watchlist:

python3 {baseDir}/scripts/yt_playlist.py bulk-create "Zwift Feb 3" \
  l3u_FAv33G0 \
  MY5omSLtAvk \
  VdaZqfEKv38 \
  Wq16lyNpmYs \
  SE7d4eaOJv4

Notes

• First run requires browser auth (opens automatically)
• Token is cached in token.pickle
• Accepts video IDs or full YouTube URLs
• Default privacy is "unlisted" for bulk-create, "private" for single create