clawspotify

What This Skill Does

ClawSpotify is a comprehensive automation skill for OpenClaw designed to grant users complete control over their Spotify playback experience via natural language or terminal commands. By leveraging a custom implementation of the SpotAPI, the skill enables users to seamlessly play, pause, resume, skip tracks, queue songs, and manage playback devices without leaving their terminal or interrupting their workflow. Whether you are using a Free or Premium Spotify account, ClawSpotify acts as a bridge between the OpenClaw AI agent and Spotify's infrastructure.

Installation

For most users, the recommended way to install ClawSpotify is through the ClawHub platform by running clawhub install clawspotify. This method automates the dependency management and path configuration. For advanced users or those preferring a manual approach, you can clone the repository from GitHub into your ~/.openclaw/workspace/skills/ directory. You will also need to install the custom SpotAPI dependency and create a wrapper script in your ~/.local/bin/ folder to ensure the skill is executable from anywhere in your path. Please ensure your system has Python 3.10+ installed prior to beginning installation.

Use Cases

• Deep Work Focus: Use the agent to start a 'Focus' playlist without alt-tabbing away from your IDE or document editor.
• Home Office Automation: Switch playback between desktop speakers and smart speakers using voice commands through your OpenClaw agent.
• Quick Management: Rapidly adjust volume or skip tracks during a meeting or while busy with a project.

Example Prompts

• "OpenClaw, start my 'Late Night Coding' playlist and set the volume to 30%.",
• "Hey, what song is currently playing on my Spotify?",
• "Queue 'Bohemian Rhapsody' by Queen next in the list."

Tips & Limitations

• Authentication: You will need to extract your sp_dc and sp_key cookies from your browser developer tools to authorize the skill. This is a one-time setup unless the cookies expire.
• Spotify App State: For the commands to execute successfully, ensure at least one Spotify device (desktop app, mobile, or web player) is active and running.
• Multi-Account: If you manage both work and personal Spotify accounts, use the --id flag during the setup process to save separate session profiles, allowing you to toggle between them effortlessly.