Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Clarified installation instructions: pip is not supported, brew is a one-liner.
What This Skill Does
Controls Apple Music on macOS through the `clawtunes` CLI. Supports playback, volume, shuffle, repeat, search, playlist management, AirPlay device switching, and Apple Music catalog browsing. macOS-only, communicates with the Apple Music app via AppleScript.
Lets agents control Apple Music programmatically without GUI interaction, enabling music control as part of automated workflows.
When to use it
- Play a specific album while working
- Skip to the next track without leaving the terminal
- Create a playlist and add songs to it
- Switch audio output to an AirPlay speaker
- Search your library for a song by partial name
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: 'Play the album Kind of Blue and set volume to 60'
- 1Run `clawtunes -N play album "Kind of Blue"` to start the album
- 2Check exit code; if multiple matches, retry with `--first` flag
- 3Run `clawtunes volume 60` to set volume
- 4Run `clawtunes status` to confirm what is now playing
Apple Music plays Kind of Blue at volume 60, status confirms the current track
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.