Apple Music
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-apple-music
技能介绍
要解决什么问题
在 macOS 上想把 Apple Music 交给 Agent 驱动时,常见痛点是:只能靠你自己点播放器,或者要写一堆零散的 AppleScript。本技能把路径固定在 ~/.clawdbot/skills/apple-music/,通过 apple-music.sh 统一暴露 本地脚本 与 MusicKit API 两条路径,让助手能改播放状态、切歌、调音量,并在有开发者凭证时做搜索、入库和播放列表操作。
技能如何工作
本地模式(无需配置) 直接调用脚本:
- 播放控制:
./apple-music.sh player,支持now、play、pause、toggle、next、prev、shuffle、repeat、volume N、song "name"等子命令。 - AirPlay:
./apple-music.sh airplay,可list、select N、add N、remove N管理输出设备。
API 模式(需 Apple Developer + MusicKit 密钥) 在完成 setup.sh(经 ./launch-setup.sh 在 Terminal 中交互)后,可用:
search "query" [--type songs|albums|artists] [--limit N]library add、播放列表playlists [list|create "Name"|add]
令牌写在 config.json,大约 6 个月 有效;401 表示过期需重跑 setup,403 多与子账号/订阅有关,404 可能是无效 ID 或地区限制。
适用边界与注意点
- API 路径需要 MusicKit key(.p8)、Key ID、Team ID,且有年费开发者账号成本。
- Agent 不要在聊天里直接跑
setup.sh;授权与粘贴 token 应通过./launch-setup.sh打开终端完成。 - 本地脚本依赖本机已安装并可用的 Apple Music / 系统环境;API 能力受 Apple Music 订阅与区域策略约束。
使用场景
- 在家用 Mac 写代码时,让 Agent 根据当前任务暂停或恢复 Apple Music,而不切到音乐 App。
- 演示或录制屏幕前,通过 `airplay list` / `select` 把输出切到指定音箱,演示结束再切回内置扬声器。
- 有 MusicKit 配置后,用 `search` 按歌名或艺人查曲库,确认结果再由 `player song` 或 API 播放列表命令拉起播放。
- 令牌临近失效出现 API 401 时,按技能说明用 `launch-setup.sh` 在终端重走授权并更新 `config.json`。
适合人员
- 每天在 macOS 上长时间写代码、希望用自然语言控制本机 Apple Music 播放状态的软件工程师
- 要做 Mac 桌面自动化或 clawdbot 技能集成、需要统一封装 AppleScript 与 MusicKit 的插件作者
- 有 Apple Developer 账号、想把曲库搜索与播放列表维护交给 Agent 的个人音乐库管理员
- 负责办公室或居家音响环境、需要程序化切换 AirPlay 输出设备的智能家居 / 桌面运维人员