A powerful integration to control Music Assistant playback, manage queues, and search music libraries across multiple providers.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install music-assistant
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 music-assistant 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 Music Assistant?
The Music Assistant skill provides a robust interface for interacting with a Music Assistant server, commonly used within Home Assistant environments. It enables users to bridge various music providers—including Spotify, Plex, and local file systems—into a unified control interface. By leveraging Openclaw Skills, developers can programmatically search for tracks, manage playback across different rooms, and automate their audio environment through a streamlined CLI or AI agent interaction.
This skill is designed for high flexibility, allowing for both simple playback commands and deep library management. It abstracts the complexity of the Music Assistant JSON-RPC API, making it easy to integrate high-quality audio control into broader automation workflows or developer tools.
Music Assistant Use Cases
- Triggering music playback as part of a smart home routine or morning alarm.
- Searching for specific artists or albums across all connected music providers at once.
- Remotely managing volume and playback queues for different speakers in a multi-room setup.
- Checking what is currently playing or retrieving recently played tracks for activity logs.
How Music Assistant Works
- The skill establishes a connection to the Music Assistant server using the MA_URL and a Long-Lived Access Token.
- Commands are issued via the mactl.py script, which translates user intent into JSON-RPC API calls.
- The Music Assistant server processes these calls by communicating with integrated music providers and the target media player.
- Real-time feedback, such as track info or queue status, is returned to the interface for the user or agent to consume.
- Advanced search queries are handled by the server's internal indexing, allowing the skill to return results from disparate sources like local storage and streaming services.
Music Assistant Setup
To get started with this integration in the context of Openclaw Skills, configure your environment with your server details and access token:
# Required configuration
export MA_URL="http://YOUR_SERVER_IP:8095/api"
export MA_TOKEN="YOUR_BEARER_TOKEN"
# Optional: Set a default player ID (find it using the players command)
export MA_PLAYER="your_player_id"
You can generate your Long-Lived Access Token in the Music Assistant web UI under Settings -> Security.
Music Assistant Data Schema & Taxonomy
The skill organizes data around players, queues, and media metadata. The following table describes the primary data points managed through Openclaw Skills:
| Object | Data Points |
|---|---|
| Player | ID, Name, Power State, Volume (0-100), Mute status |
| Queue | Queue ID, Current Track, Shuffle (enabled/disabled), Repeat (off/all/one) |
| Media | Track/Album/Artist name, Provider URI, Media Type |
| Library | Sync status, Recently played items, Search results |
Music Assistant Advanced Features
- Direct JSON-RPC command execution for operations not explicitly covered by the CLI.
- Play-by-URI support allowing for precise playback of specific tracks from Spotify or Plex.
- Multi-player enumeration, enabling the management of multiple output devices from a single agent session.
- Library synchronization triggers to force-update the metadata index across all providers.
SKILL.md
Loading
Related Openclaw Skills
Studio Service Catalog
An automated tool to fetch and display studio service details, pricing, and durations via a local script execution.
WeChat Pack
WeChat Pack is a specialized utility for converting Markdown or Word documents into perfectly formatted HTML and organized assets for WeChat Official Accounts.
SafePaste
SafePaste is a local security and compatibility layer that analyzes third-party prompts and configurations before they are applied to your OpenClaw environment.
Clawtar
A demonstration skill designed for AI agents to practice detecting, settling, and retrying Cashu-gated HTTP 402 payment flows.
MoltMedia
MoltMedia is a dedicated image-sharing platform designed for AI agents to publish and share visual content with the world.
OpenClaw Browser
A powerful browser automation skill for OpenClaw using the Chrome DevTools Protocol to capture screenshots and interact with web pages.
METADATA
Featured*
