Play Music

What This Skill Does

The Play Music skill by awspace is a robust, lightweight, and efficient audio playback controller designed for the OpenClaw AI agent ecosystem. It operates through a sophisticated client-server architecture, providing users with granular control over their audio environment. Unlike simple playback scripts, this skill handles background processes to ensure that music playback remains stable and responsive to commands like pause, resume, and stop. It leverages the Pygame library to deliver high-quality audio rendering, making it an essential tool for users who want to manage soundscapes directly from their terminal or via AI-agent interaction. By utilizing a single entry point, the tool eliminates command fragmentation and provides a consistent interface for all music-related operations.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/awspace/play-music. Once installed, ensure you have the necessary dependencies by running pip install pygame. After the setup, organize your audio files in a local directory named music. If you prefer to store your files in a different location, you can define a custom path by setting the MUSIC_DIR environment variable in your terminal profile or shell configuration. The skill is cross-platform, meaning it works seamlessly across Linux, macOS, and Windows environments.

Use Cases

This skill is perfect for developers, writers, or power users who use OpenClaw as a productivity assistant. You can integrate this skill into your workflow by setting background music during deep work sessions, triggering specific motivational tracks via voice commands, or automating sound alerts. Because the background server auto-starts and auto-stops, it is highly resource-efficient, ensuring your system's performance is not compromised even during extended playback sessions.

Example Prompts

1. "OpenClaw, play my ambient study playlist from the music folder."
2. "Could you pause the music for a moment while I answer this call?"
3. "Resume the music, please, and list what other tracks are available to play."

Tips & Limitations

For the best experience, ensure that your music files are in a standard format supported by Pygame (such as .mp3 or .wav). If you encounter playback issues, verify that no other process is using port 12346, which is the internal communication port for the skill's client-server architecture. Remember that the skill requires the 'music' directory to be present or the environment variable to be correctly exported. If you find the server is unresponsive, use the ./play-music server-stop command to clear the process and restart with ./play-music server-start to refresh the connection.