apple-music

What This Skill Does

The apple-music skill provides a comprehensive bridge between your OpenClaw agent and the Apple Music ecosystem. By leveraging both the MusicKit API and local AppleScript hooks, the skill allows for granular control over your listening experience. It serves as a unified interface to search, play, and organize music without ever leaving your terminal or agent interface. Whether you need to initiate playback of a specific artist, manage AirPlay devices in your home network, or programmatically update your playlists, this skill provides the necessary automation layer.

Installation

To install this skill, use the following command in your terminal: clawhub install openclaw/skills/skills/tyler6204/apple-music. The skill is located at ~/.clawdbot/skills/apple-music/. Note that while local playback features function out-of-the-box, full API functionality requires an Apple Developer account. You must run ./launch-setup.sh to trigger the interactive setup; do not attempt to run the setup scripts directly within the agent chat interface, as they require user interaction to authorize tokens.

Use Cases

This skill is perfect for power users who want to automate their media environment. You can integrate music control into your "Focus Mode" routines by having the agent pause your music when you start a deep work session, or automatically add songs to a "Discovery" playlist when you hear something you like during a study session. It is also highly effective for multi-room audio management, allowing users to switch AirPlay outputs instantly via voice or text commands, eliminating the need to navigate the Control Center menu.

Example Prompts

1. "Search for the latest lo-fi hip hop album and play it through my living room speakers."
2. "Add the current track to my 'Weekly Favorites' playlist and shuffle my 'Late Night' collection."
3. "Set my output to the Office HomePod and turn the volume down to 20%."

Tips & Limitations

• Tokens: The API tokens generated via setup are valid for approximately 6 months. If you encounter a 401 error, you must re-run the setup process.
• Authentication: If the browser authentication page fails to open, copy the URL printed in the terminal and navigate to it manually in Chrome for the most reliable results.
• Subscription: Ensure you have an active Apple Music subscription; a 403 error usually indicates an account permission issue rather than a configuration fault.
• Regional Locks: Note that some tracks or albums are region-locked; these will trigger a 404 error if queried from an unsupported location.