A macOS-native skill for controlling Spotify playback, volume, and media selection via CLI and AppleScript.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install spotify
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 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 Control for macOS?
The Spotify skill for Openclaw Skills provides a robust interface for managing music playback directly through your AI coding agent. Designed specifically for macOS, this skill bridges the gap between your terminal and the Spotify desktop application, allowing for seamless audio management without the overhead of API configuration. It enables users to maintain their flow state by controlling their environment through simple text or voice commands.
By utilizing the shpotify CLI and native AppleScript, this integration offers low-latency control over the Spotify app. Whether you need to toggle playback, skip a track that is breaking your concentration, or play a specific artist's discography, this tool provides the necessary hooks to turn Spotify into a programmable component of your workstation via Openclaw Skills.
Spotify Control for macOS Use Cases
- Control basic music playback like play, pause, next, and previous tracks during deep work sessions.
- Adjust Spotify volume levels precisely using commands instead of manual sliders.
- Play specific artists, albums, or tracks by passing Spotify URIs to the agent.
- Retrieve current track information and status to know what is playing without switching windows.
How Spotify Control for macOS Works
- The AI agent receives a playback or search request related to music.
- For standard controls, the skill invokes the shpotify CLI to send commands like play, pause, or vol to the system.
- For specific content requests, the agent extracts the unique Spotify ID from a web search or provided URL.
- The skill then executes a macOS AppleScript (osascript) command to tell the Spotify application to play the specific URI (artist, album, or track).
- The Spotify desktop app processes the command locally, ensuring immediate response and support for Spotify Connect devices.
Spotify Control for macOS Setup
To use this skill with Openclaw Skills, ensure you are running macOS and have the Spotify desktop app installed.
# Install the required shpotify CLI via Homebrew
brew install shpotify
# Open the Spotify app and log in
open -a Spotify
Spotify Control for macOS Data Schema & Taxonomy
The skill interacts with the macOS operating system and the Spotify application using the following structure:
| Feature | Mechanism | Data Type |
|---|---|---|
| Playback Control | shpotify CLI | Command-line arguments |
| Media Selection | AppleScript | Spotify URIs (Artist, Album, Track) |
| Status Retrieval | System Shell | Metadata strings |
| Volume Control | AppleScript | Integer (0-100) |
Spotify Control for macOS Advanced Features
- Support for Spotify Connect, allowing you to control Sonos or other networked speakers through the desktop app.
- Programmatic volume stepping (up/down 10%) or absolute volume setting.
- Direct URI playback support which bypasses the need for manual searching in the UI.
- Zero-API-key configuration, leveraging local system permissions instead of complex OAuth flows.
SKILL.md
Loading
Related Openclaw Skills
LINE Client Skill
A comprehensive LINE messaging integration for AI agents utilizing the Chrome extension gateway for JSON-based API access.
ClawRAG Connector
A production-ready, self-hosted RAG infrastructure that provides local long-term memory and hybrid search capabilities for your AI agents.
MikroTik RouterOS Management Skill
A comprehensive AI agent skill for managing MikroTik RouterOS devices through API-driven automation and real-time monitoring.
Gaode Map (AMap) Integration
A Python-based skill for integrating Gaode Map (AMap) capabilities like POI search and multi-modal route planning into AI agent workflows.
Todoist CLI
A powerful command-line interface for managing Todoist tasks, allowing for rapid task creation, filtering, and organization from the terminal.
Gmail Recent Digest
An automated utility for Openclaw Skills that retrieves recent unread Gmail messages and generates a concise, summarized digest.
Featured*
