clawspotify_skill

Overview

This skill lets your OpenClaw agent control Spotify playback from the command line. It supports play, pause, resume, skip, previous, restart, search, queue, volume, shuffle, repeat, and now-playing status. It works with both Free and Premium accounts and stores a browser-cookie-based session for quick reuse. Multi-account support and a simple setup command make it easy to manage multiple Spotify profiles.

How this skill works

The skill uses your Spotify browser cookies (sp_dc and sp_key) to authenticate without an official API key. You run a one-time setup command that saves a session file (~/.config/spotapi/session.json). After setup, the agent sends playback and search commands to any active Spotify device associated with your account. If cookies expire, re-running setup with fresh cookie values restores access.

When to use it

• Start, pause, resume, skip, or restart music on any active Spotify device
• Search tracks, artists, or playlists and preview top results without playing
• Add tracks or URIs to the play queue
• Check what’s playing now and view track metadata
• Adjust playback volume, or toggle shuffle and repeat modes
• Manage multiple Spotify accounts from one environment

Best practices

• Run setup using fresh sp_dc and sp_key values copied from open.spotify.com DevTools
• Keep at least one Spotify device (phone, PC, or web) open for playback commands to take effect
• Use the --id flag to separate and name multiple account sessions
• Re-run setup if you encounter 401 errors; browser cookies expire periodically
• On Windows, use WSL, Git Bash, or Cygwin to run the skill reliably

Example use cases

• Quickly play a requested song during a chat: clawspotify play "Song Title"
• Add a suggested track to the current queue without interrupting playback
• Search playlists for mood-based music and start playback with play-playlist
• Mute or set a fixed volume before a call using clawspotify volume 0 or 30
• Verify what a user is listening to with clawspotify status