An AI-powered music management skill offering intelligent playback control, feedback-aware recommendations, and automated governance for Spotify.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install spotify-intelligence
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-intelligence 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 Intelligence?
Spotify Intelligence is a high-performance music management module designed to integrate seamlessly with AI agents. It leverages the Spotify API to provide more than just basic playback; it integrates a feedback loop and decision-making engine to curate music based on evolving user preferences. By utilizing Openclaw Skills, developers can empower their agents to handle complex music tasks such as mood-shifting recommendations, playlist governance, and explainable decision-making.
The skill operates through a series of modular Python-based entrypoints, ensuring a robust and extensible framework for music automation. It moves beyond standard API wrappers by maintaining its own local state and logic layers, allowing the agent to understand why specific songs are chosen and how they align with the user's current context or historical feedback.
Spotify Intelligence Use Cases
- Automating music playback based on specific moods, activities, or environment triggers.
- Generating intelligent song recommendations using specialized passend, mood-shift, or explore modes.
- Building a feedback-aware music library that learns from skips, likes, and dislikes in real-time.
- Maintaining a governed record of all playlist decisions and AI-driven music choices for auditability.
How Spotify Intelligence Works
- The skill authenticates with the Spotify API using OAuth credentials stored locally in data/tokens.json.
- Users or parent agents interact via Python runners to control playback, search for songs, or request recommendations.
- The system processes user feedback, including likes, dislikes, and skips, to update an internal scoring model.
- Derived features are periodically rebuilt to refine recommendation accuracy based on the updated feedback loop.
- Every decision and action is logged within a local SQLite database to ensure governance and explainable AI logic.
Spotify Intelligence Setup
To get started with this addition to your Openclaw Skills library, follow these steps:
- Set the required environment variables:
export SPOTIFY_CLIENT_ID='your_client_id'
export SPOTIFY_CLIENT_SECRET='your_client_secret'
export SPOTIFY_REDIRECT_URI='your_callback_url'
- Run the authentication script to generate your local tokens:
python scripts/auth/oauth_auth.py
- Ensure the local data directory is initialized to store tokens and the SQLite database.
Spotify Intelligence Data Schema & Taxonomy
The skill manages data across JSON and SQLite formats to ensure persistence and performance within the Openclaw Skills ecosystem:
| Data Component | Format | Purpose |
|---|---|---|
| tokens.json | JSON | Stores OAuth access and refresh tokens for persistent sessions. |
| spotify-intelligence.sqlite | SQLite | Manages decision logs, feedback tracking, and derived feature sets. |
| scripts/ | Directory | Contains the functional logic for playback, auth, and recommendation layers. |
| references/ | Markdown | Technical documentation for the read-layer, feedback-loop, and governance modules. |
Spotify Intelligence Advanced Features
- Explainable playlist decisions backed by a governance database to track why a specific track was queued.
- Specialized recommendation modes including passend for similar tracks, mood-shift for transitions, and explore for discovery.
- Feedback-aware scoring system that dynamically adapts to user interaction patterns like skips and keeps.
- Deep integration with Openclaw Skills for multi-agent workflows and automated music curation.
- Intelligent search capabilities that prioritize own-playlist content before falling back to global Spotify results.
SKILL.md
Loading
Related Openclaw Skills
NPS NAV Skill
A developer-focused tool for querying Indian NPS fund NAVs, historical performance, and scheme metadata through the npsnav.in API.
mfapi
A powerful tool to query Indian mutual fund NAV data, historical performance, and scheme information through the free MFapi.in REST API.
Get Kalshi Live Games
Automate the extraction of live sports market data and probabilities directly from Kalshi using real-time browser interaction.
Douyin Video Fetch
A specialized utility for downloading high-quality, watermark-free Douyin videos via URL or ID for local processing.
A-Share Multi-Agent Research Framework
A sophisticated multi-agent framework for deep A-share market research, industry chain analysis, and automated investment reporting.
Gladia YouTube and Audio Transcription
An automated transcription tool that converts YouTube videos and audio URLs into text using the Gladia API for LLM summarization and analysis.
Featured*
