spotify-claw

What This Skill Does

spotify-claw is a powerful, integrated OpenClaw skill designed for users who want granular control over their Spotify Premium account directly from the command line or via natural language triggers. It acts as an intermediary between OpenClaw and the Spotify Web API, offering a full suite of features ranging from standard playback management to sophisticated music discovery and library analysis. The skill is designed to auto-launch the desktop application, manage authentication securely through the macOS Keychain, and interpret voice or text commands into executable system operations.

Installation

Installation is straightforward via the ClawHub: run clawhub install openclaw/skills/skills/mixx85/spotify-claw. After installation, you must register a new application at the Spotify Developer Dashboard. Ensure the Redirect URI is set to http://127.0.0.1:8888/callback. Once registered, store your Client ID and Client Secret in the macOS Keychain using the security add-generic-password commands provided. Finally, execute python3 ~/.openclaw/scripts/spotify.py now to trigger the initial OAuth2 browser handshake.

Use Cases

This skill is perfect for power users who dislike context-switching between their terminal and the Spotify app. It excels at deep-dive music analysis, such as generating genre profiles, identifying top-performing tracks over various timeframes, or building custom playlists based on artist similarities. It is particularly useful for discovery; by leveraging the discover command, users can explore new soundscapes based on their existing listening habits without needing to rely solely on Spotify's built-in algorithm. It also facilitates rapid library management, such as bulk-viewing liked songs or searching for specific tracks by artist.

Example Prompts

1. "Включи что-нибудь из трип-хопа, чтобы расслабиться."
2. "Какие у меня были самые популярные треки за последние полгода?"
3. "Поставь музыку как у Portishead, но только самые энергичные треки."

Tips & Limitations

Always ensure your Spotify Premium status is active, as the API restricts playback features for free accounts. Because this skill relies on local script execution, ensure your Python environment has the necessary dependencies installed. Note that the discovery engine runs locally using your history, which means it may behave differently than the 'Discover Weekly' playlist generated by Spotify. Use the devices command if you encounter playback issues to confirm the correct output sink is selected.