A robust, client-server music player skill for AI agents providing full playback control and resource-efficient background execution.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install play-music
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 play-music 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 Play Music Skill?
The Play Music Skill is a sophisticated audio management tool designed to integrate seamlessly into your developer environment. As a key component of Openclaw Skills, it provides a centralized entry point for playing, pausing, resuming, and stopping music files. By utilizing a client-server architecture, it ensures that audio playback remains stable in the background without blocking your primary agent workflows.
This skill is built on top of the Pygame library, offering high-quality audio processing and cross-platform compatibility across macOS, Windows, and Linux. It is specifically engineered for developers and AI agents who need a programmatic way to manage media assets with minimal overhead and maximum reliability.
Play Music Skill Use Cases
- Automating background music playback during focused coding sessions.
- Integrating audio cues or status notifications into AI agent workflows.
- Managing media libraries through simple command-line interfaces or scriptable actions.
- Building custom productivity environments that respond to voice or text-based music commands.
How Play Music Skill Works
- The user or agent triggers the play-music script with a specific command like play or list.
- The system checks for the presence of the music-server.py background process and initializes it if necessary.
- The Pygame mixer module loads the requested audio file from the designated music directory.
- Commands (play, pause, resume, stop) are transmitted from the client script to the background server via a local port.
- The server manages the playback lifecycle and automatically terminates when the music stops to conserve system resources.
Play Music Skill Setup
1. Install Dependencies
Ensure you have the Pygame library installed for full playback control:
pip install pygame
2. Prepare Music Directory
Create a folder named music in the skill directory or define a custom path:
mkdir music
3. Configure Environment (Optional)
You can customize the music location and default tracks via environment variables:
export MUSIC_DIR="/path/to/your/music"
export DEFAULT_SONG="focus-track.mp3"
Play Music Skill Data Schema & Taxonomy
The Play Music Skill manages its data and configuration through environment variables and a standardized file structure. This ensures compatibility within the wider Openclaw Skills framework.
| Component | Type | Description |
|---|---|---|
| MUSIC_DIR | Environment Variable | Path to the directory containing audio files |
| DEFAULT_SONG | Environment Variable | The filename used when the play command is called without arguments |
| music/ | Directory | The default local storage for mp3/audio assets |
| _meta.json | Metadata File | Contains the skill definition and integration parameters for Openclaw Skills |
Play Music Skill Advanced Features
- Resource-efficient design with automatic server startup and shutdown.
- Decoupled client-server architecture for non-blocking playback management.
- Custom environment variable support for dynamic library path mapping.
- Detailed playback status reporting to monitor current track and server health.
- Support for a wide range of audio formats via the Pygame backend.
SKILL.md
Loading
Related Openclaw Skills
PDF Processing Toolkit
A versatile toolkit for programmatic PDF manipulation, extraction, and generation using Python and CLI tools.
Email Management & Automation
A comprehensive skill for automating email dispatch and management with support for attachments and multiple providers.
Sprite Animator
Transform static images into 16-frame animated pixel art GIFs using Gemini AI and a single-request sprite sheet generation process.
Secret Portal
A secure, one-time-use web interface for entering environment variables and API keys without exposing them to logs or chat history.
Exchange Rate
A real-time currency conversion and forex lookup tool powered by QVeris for accurate financial data within your agent workflow.
SiliconFlow Multi-modal Media Services
A comprehensive multi-modal skill for generating high-quality AI images, videos, and audio using SiliconFlow's powerful model library.
Featured*
