A powerful integration for macOS that allows AI agents to control playback, manage library content, and handle AirPlay routing through AppleScript and the MusicKit API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install apple-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 apple-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 Apple Music?
The Apple Music skill provides a dual-layered approach to music automation on macOS. It utilizes native AppleScript for immediate local playback controls, volume adjustments, and AirPlay device management without requiring external API keys. For more advanced operations, it integrates with the official Apple MusicKit API, allowing agents to perform deep searches across the global catalog, create playlists, and add songs to a user's library. This versatility makes it a cornerstone among Openclaw Skills for users looking to bridge the gap between AI workflows and their media environment.
Apple Music Use Cases
- Automating daily music routines or focus playlists via AI command.
- Searching the Apple Music catalog for specific artists or albums and adding them to a library.
- Programmatically managing multi-room audio by selecting or adding AirPlay devices.
- Building custom music discovery tools that interface directly with a personal Apple Music account.
How Apple Music Works
- Local playback and AirPlay commands are executed through a shell wrapper that triggers AppleScript events in the macOS Music app.
- API-based functions utilize a Node.js backend to communicate with Apple Music servers using developer-signed JWT tokens.
- The interactive setup process links a developer MusicKit key with user authorization to enable private library access.
- Commands are processed as CLI arguments, allowing an AI agent to interpret user intent and map it to specific script actions.
- Session data and tokens are securely stored in a local configuration file to maintain persistent access for up to six months.
Apple Music Setup
To integrate this into your collection of Openclaw Skills, follow these steps:
- Ensure you have Node.js and curl installed on your macOS system.
- For API access, obtain a MusicKit key (.p8), Key ID, and Team ID from the Apple Developer portal.
- Execute the interactive setup script to authorize the skill:
./launch-setup.sh
- Follow the terminal prompts to complete the browser-based authorization and save your configuration.
Apple Music Data Schema & Taxonomy
| File/Component | Purpose |
|---|---|
| config.json | Contains the encrypted developer tokens and user session keys. |
| apple-music.sh | The primary entry point for routing local and API-based commands. |
| API Metadata | Returns structured JSON containing song IDs, artist metadata, and album artwork. |
Apple Music Advanced Features
- Granular AirPlay control including the ability to add or remove specific speakers from the output group.
- Comprehensive search filtering by song, album, or artist with customizable result limits.
- Automatic token refresh logic to handle authorization lifecycle within the Openclaw Skills framework.
- Full support for playback states including shuffle, repeat modes, and precise volume normalization.
SKILL.md
Loading
Related Openclaw Skills
Apple Mail
A specialized macOS integration for Mail.app that enables lightning-fast email searching, reading, and management through a hybrid AppleScript and SQLite approach.
Apple Contacts
A macOS-native skill that enables AI agents to query the Contacts.app for names, phone numbers, and email addresses using AppleScript.
Apple Calendar for macOS
A macOS-native integration enabling AI agents to perform full CRUD operations and event management on Calendar.app using AppleScript.
Polymarket US Prediction Markets
Access real-time prediction market data and execute trades on Polymarket US using Openclaw Skills.
Apple Photos Integration
A specialized tool for searching, listing, and exporting media from the macOS Photos.app library using script-driven SQLite queries.
Better Notion
A comprehensive Notion API integration providing full CRUD capabilities for pages, databases, and content blocks.
METADATA
Featured*
