A macOS-native skill that uses AppleScript to search and play Spotify tracks directly through the desktop application.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install spotplay
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 spotplay 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 spotplay?
spotplay is a specialized integration designed for Openclaw Skills that bridges the gap between AI agents and the native Spotify desktop application on macOS. While other tools might focus on CLI-only playback or complex web-based device switching, this skill prioritizes the local Spotify.app environment. By leveraging AppleScript, it ensures that music playback is reliable, visual, and correctly routed to the user's active machine.
This tool is specifically optimized for scenarios where a user wants to hear a specific song or artist without the ambiguity of headless players. It provides a robust alternative to standard CLI players by ensuring the official Spotify client is active and responding to commands, making it a vital component for users of Openclaw Skills who value a seamless media experience.
spotplay Use Cases
- Requesting specific songs, artists, or keywords using natural language prompts within Openclaw Skills.
- Automatically launching the Spotify desktop application if it is not currently running.
- Ensuring music playback occurs on the local macOS device rather than a remote or web-based player.
- Fetching track metadata and URIs for debugging or logging purposes during an automated session.
How spotplay Works
- The skill receives a text-based search query from the user via the Openclaw Skills interface.
- It searches the Spotify database to identify the most relevant track and retrieves its unique Spotify URI.
- An AppleScript command is generated to activate the Spotify.app on macOS.
- The script instructs Spotify to play the specific URI retrieved in the search phase.
- The skill confirms the execution by returning the song name, artist, and URI to the agent.
spotplay Setup
To use this skill within the Openclaw Skills framework, ensure your environment meets the following requirements:
- Operating System: macOS.
- Application: Official Spotify.app must be installed in the Applications folder.
- Permissions: Ensure your terminal or AI agent host has the necessary permissions to execute AppleScript and control Spotify.
# Verify Spotify is installed via Homebrew if needed
brew install --cask spotify
spotplay Data Schema & Taxonomy
The skill processes and returns data in a structured format to ensure compatibility with other Openclaw Skills components:
| Property | Description |
|---|---|
| input_query | The search text provided by the user (keywords/artist/title) |
| track_name | The human-readable title of the track found |
| artist_name | The primary artist associated with the track |
| spotify_uri | The unique resource identifier used by the Spotify app |
| playback_status | Confirmation of whether the AppleScript command succeeded |
spotplay Advanced Features
- Intelligent App Activation: Automatically wakes and focuses the Spotify application if it is minimized or closed.
- High Reliability Playback: Bypasses the common 'no response' issues found in CLI-based players by targeting the native macOS GUI layer.
- Contextual Feedback: Provides full track metadata back to the Openclaw Skills agent to allow for follow-up questions or playlist management.
- Keyword Versatility: Supports broad searches including album names, artists, or specific song titles to find the best match.
SKILL.md
Loading
Related Openclaw Skills
vefaas-browser-use
A serverless AI agent skill that leverages Large Language Models to automate browser tasks via Volcano Engine Function Service.
Creator Intel V5
A hard-tech intelligence aggregator that filters out marketing hype to deliver pure engineering specifications and architectural insights.
ai-app-lab
A comprehensive repository of 27 AI application templates and reference architectures built on Volcengine infrastructure.
Trading DevBox
An automated sandbox that transforms natural language trading intents into executable Python backtesting strategies.
K-Cinema Bridge
Integrate real-time Korean cinema rankings and detailed movie metadata from major multiplexes into your AI agent.
Clawfy
A proactive context-aware assistant that surfaces relevant Openclaw Skills based on your real-time browser activity and recent project history.
Featured*
