A sophisticated integration for controlling Spotify playback on remote Connect devices across multiple authenticated accounts.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install spotify-connect
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install spotify-connect using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Spotify Connect?
The Spotify Connect skill for Openclaw Skills empowers AI agents to manage audio playback across a wide range of hardware, including speakers, smart TVs, and desktop applications. By utilizing the Spotify Web API and Spotify Connect protocol, this tool enables seamless music control through simple commands.
Designed for flexibility, this skill stands out by supporting multiple authenticated profiles, allowing users to switch between accounts or search for devices across different subscriptions in parallel. It transforms your AI assistant into a centralized media controller for your entire home or office environment.
Spotify Connect Use Cases
- Automating music playback transitions between rooms or devices using AI commands.
- Managing shared speaker systems in office environments with multiple user profiles.
- Searching for and playing specific tracks, albums, or curated playlists via natural language.
- Controlling volume, shuffle modes, and playback status on remote devices like Echo speakers or smart TVs.
How Spotify Connect Works
- The skill authenticates with the Spotify API using OAuth, storing refreshing tokens for one or more named profiles.
- When a command is issued, the skill can scan all authenticated accounts in parallel to identify available Spotify Connect hardware.
- User-defined aliases or fuzzy matching logic are used to resolve the correct target device from the available list.
- The system automatically switches to the account associated with the target device if necessary.
- Playback commands (play, pause, skip, volume) are transmitted via the Spotify Web API to the active device session.
Spotify Connect Setup
- Create a Spotify application at the Spotify Developer Dashboard, setting the redirect URI to
http://127.0.0.1:8888/callbackand enabling the Web API. - Configure your environment variables with your application credentials:
export SPOTIFY_CLIENT_ID="your-client-id"
export SPOTIFY_CLIENT_SECRET="your-client-secret"
- Initialize the authentication process for your primary account using the Openclaw Skills framework:
uv run {baseDir}/scripts/spotify.py auth --name "your_name"
- (Optional) Create a device alias file at
~/.openclaw/spotify-connect/devices.jsonto map hardware names to friendly aliases like "kitchen" or "office".
Spotify Connect Data Schema & Taxonomy
The skill maintains local configuration and session data to ensure fast response times and profile persistence:
| Data Component | Location | Purpose |
|---|---|---|
| Accounts Registry | accounts.json |
Stores encrypted OAuth tokens and profile metadata. |
| Device Aliases | devices.json |
User-defined mapping for fuzzy device matching. |
| Dependency Logic | spotify.py |
Uses PEP 723 inline metadata for automated environment management via uv. |
Spotify Connect Advanced Features
- Multi-account profile management allowing for independent music libraries and playlists.
- Cross-account device discovery that scans all linked profiles simultaneously to find active hardware.
- Fuzzy device name matching which allows for flexible naming conventions when targeting speakers.
- Full support for Spotify URI and search query playback for precise media selection.
- Automatic dependency handling via uv, ensuring a clean installation without manual pip management.
SKILL.md
Loading
Related Openclaw Skills
Homelab Cluster Management
A comprehensive system for managing distributed AI inference clusters across heterogeneous hardware using Ollama, llama.cpp, and LiteLLM.
proxymock
proxymock is a transparent proxy-based tool designed to capture, inspect, and replay real API and database traffic to create instant mocks and automated tests without code changes.
TikTok Android Bot
A professional-grade ADB automation tool for TikTok that uses AI or templates to drive authentic engagement on Android devices.
Docker Manager
A powerful skill enabling AI agents to manage Docker environments through container lifecycle control and image maintenance.
Google Finance Stock Tracker
An automated stock monitoring tool that fetches data from Google Finance to provide price alerts, news updates, and heuristic buy/sell signals.
Matrix Device Verification
A cryptographic utility for verifying and cross-signing Matrix devices to ensure secure end-to-end encryption.
Featured*
