AgentSkillsCN

managing-apple-music

在为Claude 4.5模型优化CLAUDE.md、AGENTS.md、自定义命令，或技能文件时，可调用此技能——系统性地应用Anthropic官方记录的最佳实践，而非一味自行摸索改进之道。

SKILL.md
--- frontmatter
name: managing-apple-music
description: Control Apple Music on macOS via the `clawtunes` CLI (play songs/albums/playlists, control playback, volume, shuffle, repeat, search, catalog lookup, AirPlay, and playlist management). Use when a user asks to play music, search for songs, control audio playback, or manage Apple Music settings.
homepage: https://github.com/forketyfork/clawtunes
metadata:
  {
    "openclaw":
      {
        "emoji": "🎵",
        "os": ["darwin"],
        "requires": { "bins": ["clawtunes"] },
        "install":
          [
            {
              "id": "brew",
              "kind": "brew",
              "tap": "forketyfork/tap",
              "formula": "clawtunes",
              "bins": ["clawtunes"],
              "label": "Install clawtunes via Homebrew",
            },
          ],
      },
  }

Apple Music CLI

Use clawtunes to control Apple Music from the terminal. Search and play music, control playback, adjust volume, manage playlists, manage shuffle/repeat, browse the Apple Music catalog, and connect to AirPlay devices.

Setup

  • •Install (Homebrew): brew tap forketyfork/tap && brew install clawtunes
  • •Install (pip): pip install clawtunes
  • •macOS-only; requires Apple Music app.

Play Music

  • •Play a song: clawtunes play song "Song Name"
  • •Play an album: clawtunes play album "Album Name"
  • •Play a playlist: clawtunes play playlist "Playlist Name"
  • •When multiple matches exist, an interactive numbered menu appears for selection.

Playback Control

  • •Pause: clawtunes pause
  • •Resume: clawtunes resume
  • •Next track: clawtunes next
  • •Previous track: clawtunes prev
  • •Show now playing: clawtunes status

Volume

  • •Show volume: clawtunes volume
  • •Set volume: clawtunes volume 50
  • •Adjust volume: clawtunes volume +10 or clawtunes volume -10
  • •Mute: clawtunes mute
  • •Unmute: clawtunes unmute

Shuffle and Repeat

  • •Enable/disable shuffle: clawtunes shuffle on or clawtunes shuffle off
  • •Set repeat mode: clawtunes repeat off, clawtunes repeat all, or clawtunes repeat one

Search

  • •Search songs and albums: clawtunes search "query"
  • •Include playlists: clawtunes search "query" -p
  • •Songs only: clawtunes search "query" --no-albums
  • •Limit results: clawtunes search "query" -n 20

Love/Dislike

  • •Love current track: clawtunes love
  • •Dislike current track: clawtunes dislike

Playlists

  • •List all playlists: clawtunes playlists
  • •Create a playlist: clawtunes playlist create "Road Trip"
  • •Add a song to a playlist: clawtunes playlist add "Road Trip" "Kickstart My Heart"
  • •Remove a song from a playlist: clawtunes playlist remove "Road Trip" "Kickstart My Heart"

AirPlay

  • •List devices: clawtunes airplay
  • •Select device: clawtunes airplay "Device Name"
  • •Deselect device: clawtunes airplay "Device Name" --off

Apple Music Catalog

  • •Search the streaming catalog: clawtunes catalog search "Bowie Heroes"
  • •Limit catalog results: clawtunes catalog search "Bowie Heroes" -n 5

Notes

  • •macOS-only (uses AppleScript to communicate with Apple Music).
  • •If automation permissions are requested, grant access in System Settings > Privacy & Security > Automation.