Apple Music 控制:通过 CLI 管理 macOS 音频 - Openclaw Skills

作者:互联网

2026-04-10

AI教程

什么是 Apple Music 控制?

此技能利用 clawtunes 命令行界面提供对 Apple Music 的全面控制。它允许开发人员和高级用户在不离开终端或切换焦点的情况下与音乐库进行交互。通过使用此类 Openclaw Skills,用户可以将音乐管理集成到自动化工作流中,底层使用 AppleScript 直接与原生 macOS 音乐应用通信。

它弥合了 AI 驱动指令与本地媒体播放之间的鸿沟,为从音量控制到 AirPlay 路由的所有功能提供了一套强大的工具。无论是在搜索全球 Apple Music 目录还是管理本地播放列表,此集成都能确保您的音乐环境始终可以通过智能助手访问。

下载入口:https://github.com/openclaw/skills/tree/main/skills/forketyfork/clawtunes

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install clawtunes

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 clawtunes。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

Apple Music 控制 应用场景

  • 通过语音或文本命令启动特定的播放列表或专辑。
  • 自动设置播放模式(如随机播放和重复播放),以便进入深度工作状态。
  • 搜索 Apple Music 目录并发现新曲目。
  • 管理 AirPlay 设备连接,实现多房间音频设置。
  • 在编码过程中快速调整音量和跳过曲目,无需离开 IDE。
Apple Music 控制 工作原理
  1. 用户向 AI 助手提供有关音乐播放或媒体库管理的指令。
  2. 助手根据用户意图,调用带有适当标志和参数的 clawtunes CLI 工具。
  3. clawtunes 工具使用 AppleScript 与 macOS 本地的 Apple Music 应用程序交互以执行请求。
  4. 播放开始、设置更改或搜索结果返回到用户界面供查看。
  5. 如果搜索出现多个匹配项,可配置该技能自动选择第一个结果或提示更具体的查询。

Apple Music 控制 配置指南

要从 Openclaw Skills 集合中开始使用此集成,请使用 Homebrew 安装 clawtunes CLI:

brew tap forketyfork/tap
brew install clawtunes

注意:此技能仅限 macOS。请确保已安装 Apple Music 应用,并在提示时于“系统设置 > 隐私与安全性 > 自动化”中授予自动化权限。

Apple Music 控制 数据架构与分类体系

该技能与 Apple Music 媒体库交互,并根据执行的命令返回信息。数据分为以下功能区域:

类别 核心命令 处理的数据
播放控制 play, pause, resume, next, prev 控制当前音频流状态和曲目导航。
音量水平 volume, mute, unmute 管理相对和绝对音量百分比。
媒体库查询 search, catalog, playlists 从本地和云端源检索曲目、专辑和播放列表元数据。
偏好设置 shuffle, repeat, love, dislike 为当前会话设置用户偏好和播放模式。
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: {"clawdbot":{"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 install forketyfork/tap/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"
  • Always use the --non-interactive (-N) flag to prevent interactive prompts: clawtunes -N play song "Song Name"
  • If the command exits with code 1 and lists multiple matches, retry with a more specific song/album/playlist name.
  • If a more specific name still returns multiple matches, use the --first (-1) flag to auto-select the first result: clawtunes -1 play song "Song Name"

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
  • Note: Catalog search is browse-only. To add songs to playlists, they must first be in your library. Use Apple Music app to add catalog items to your library before managing them with clawtunes.

Notes

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

相关推荐