---

name: youtube-music version: 1.0.0 description: "Control YouTube Music with natural language. Play, pause, skip, search, manage playlists, and queue tracks. Full playback control via browser automation." homepage: "https://github.com/paragshah/openclaw-youtube-music" metadata: {"clawdbot":{"emoji":"🎵","category":"media","requires":{"bins":["node"],"env":["YOUTUBE_MUSIC_BROWSER_PROFILE"]}}}

YouTube Music Control Skill 🎵

Control YouTube Music with natural language commands. Uses browser automation for full playback control.

Quick Start

# No setup needed - uses OpenClaw browser
# Optional: Set default profile in TOOLS.md

Commands

Playback Control

• Play: "play [song name]" / "play [artist]" / "play [playlist]"
• Pause: "pause" / "stop"
• Resume: "resume" / "continue"
• Skip: "skip" / "next"
• Previous: "previous" / "back"
• Volume: "volume 50%" / "set volume to 80"
• Mute: "mute" / "unmute"

Search & Discovery

• Search: "search for [query]" / "find [artist]"
• Trending: "what's trending" / "trending now"
• Recommendations: "recommend similar" / "more like this"

Library & Playlists

• Playlists: "show my playlists" / "create playlist [name]"
• Add to Playlist: "add this to [playlist]"
• Liked Songs: "show liked songs" / "like this"

Queue Management

• Queue: "show queue" / "what's next"
• Add to Queue: "queue [song]"
• Clear Queue: "clear queue"

Information

• Now Playing: "what's playing" / "current track"
• Lyrics: "show lyrics" / "lyrics"
• Artist Info: "about [artist]"

Usage Examples

"play Ye Tune Kya Kiya by Javed Bashir"
"pause the music"
"skip to next track"
"set volume to 75%"
"search for Arijit Singh hits"
"add this to my workout playlist"
"what's playing now?"
"show me the lyrics"
"queue some chill Bollywood songs"

Implementation Notes

Browser Automation

Uses OpenClaw's browser tool with YouTube Music:

• Profile: openclaw (isolated browser)
• Base URL: https://music.youtube.com
• CDP Port: 18800

Key Selectors (Dynamic)

Selectors are resolved via snapshot refs, not hardcoded:

• Player controls: pause, play, skip, previous
• Search box: combobox with placeholder
• Volume slider: range input
• Queue: up next panel
• Lyrics: lyrics tab

Error Handling

• Browser not running → Auto-start
• Video unavailable → Suggest alternatives
• Network issues → Retry with backoff
• No search results → Show spelling suggestions

Advanced Features

Smart Search

• Fuzzy matching for song names
• Artist/album disambiguation
• Auto-play top result if exact match

Context Awareness

• Remembers last played track
• Tracks listening history
• Suggests based on time of day

Multi-Room Support

• Cast to different devices
• Sync playback across tabs
• Group control (future)

Configuration

Add to TOOLS.md:

### YouTube Music
- Default profile: openclaw
- Preferred quality: high
- Auto-play: on
- Shuffle default: off

Dependencies

• OpenClaw browser tool
• YouTube Music (music.youtube.com)
• No API keys required

Limitations

• Requires browser to be running
• Some features need YouTube Premium
• Lyrics availability varies by region
• Queue management limited to current session

Future Enhancements

• YouTube Music API integration (if available)
• Offline mode with cached tracks
• Cross-platform sync
• Voice control integration
• Smart playlists based on mood/activity

Examples

Play a Song

User: "play Tuna Kay Keya"
Assistant: "Found 'Ye Tune Kya Kiya' by Javed Bashir. Playing now! 🎵"

Control Playback

User: "pause"
Assistant: "Paused. Press play to resume. ⏸️"

User: "skip"
Assistant: "Skipping to next track. ⏭️"

Search & Discover

User: "find similar to this"
Assistant: "Based on 'Ye Tune Kya Kiya', you might like:
- 'Kaise Hua' by Vishal Mishra
- 'Aankhon Se Batana' by Dikshant
- 'Kali Kali Zulfon Ke' by Madhur Sharma"

Playlist Management

User: "add this to my Bollywood Classics"
Assistant: "Added 'Ye Tune Kya Kiya' to 'Bollywood Classics' playlist. ✓"

Testing

Test the skill with:

# Test search
"search for Pritam songs"

# Test playback
"play a sample track"
"pause"
"skip"

# Test volume
"set volume to 50%"
"mute"
"unmute"

---

Skill Author: Your AI Assistant
License: MIT
Status: Ready for production 🚀