Apple Music 控制:通过 CLI 管理 macOS 音频 - Openclaw Skills
作者:互联网
2026-04-10
什么是 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。
- 用户向 AI 助手提供有关音乐播放或媒体库管理的指令。
- 助手根据用户意图,调用带有适当标志和参数的 clawtunes CLI 工具。
- clawtunes 工具使用 AppleScript 与 macOS 本地的 Apple Music 应用程序交互以执行请求。
- 播放开始、设置更改或搜索结果返回到用户界面供查看。
- 如果搜索出现多个匹配项,可配置该技能自动选择第一个结果或提示更具体的查询。
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 +10orclawtunes volume -10 - Mute:
clawtunes mute - Unmute:
clawtunes unmute
Shuffle and Repeat
- Enable/disable shuffle:
clawtunes shuffle onorclawtunes shuffle off - Set repeat mode:
clawtunes repeat off,clawtunes repeat all, orclawtunes 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.
相关推荐
专题
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
+ 收藏
最新数据
相关文章
生成 Tesla 车身改色膜:用于 3D 显示的 AI 图像生成 - Openclaw Skills
Taiwan MD:面向台湾的 AI 原生开放知识库 - Openclaw Skills
自学习与迭代演进:AI Agent 成长框架 - Openclaw Skills
HIPC Config Manager: 安全的 API 凭据处理器 - Openclaw Skills
Outline 知识库:用于文档的 AI agent 集成 - Openclaw Skills
MongoDB Slowlog Analysis: 优化数据库性能 - Openclaw Skills
Crazyrouter 翻译:AI 驱动的多模型翻译 - Openclaw Skills
sqlx Code Review:优化 Rust 数据库查询 - Openclaw Skills
Lead Scoring:AI 驱动的 B2B 转化预测 - Openclaw Skills
中国服装采购:制造与供应链指南 - Openclaw Skills
AI精选
