← 返回 Skills 市场
forketyfork

clawtunes

作者 forketyfork · GitHub ↗ · v0.3.1
darwin ✓ 安全检测通过
2403
总下载
3
收藏
3
当前安装
3
版本数
在 OpenClaw 中安装
/install clawtunes
功能描述
Control Apple Music on macOS via the `clawtunes` CLI (play songs/albums/playlists, control playback, volume, shuffle, repeat, search, catalog lookup, AirPlay...
使用说明 (SKILL.md)

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.
安全使用建议
This skill is coherent for controlling Apple Music via the clawtunes CLI. Before installing, verify you trust the Homebrew tap (forketyfork/tap) and review its formula/source on the project GitHub to ensure it matches the published code. Expect macOS Automation permission prompts (System Settings > Privacy & Security > Automation) so the CLI can control Apple Music; grant only if you trust the binary. Because this skill executes a locally-installed binary, avoid installing it from untrusted taps or running unfamiliar versions. Otherwise the skill's requirements and instructions align with its stated purpose.
功能分析
Type: OpenClaw Skill Name: clawtunes Version: 0.3.1 The skill bundle is benign. It clearly defines its purpose as controlling Apple Music on macOS using the `clawtunes` CLI. Installation is handled via Homebrew, a standard package manager, and all instructions for the AI agent are directly related to using `clawtunes` for music control (play, pause, volume, search, playlists). There is no evidence of prompt injection attempts, data exfiltration, persistence mechanisms, obfuscation, or any other malicious intent within the skill's instructions or metadata. The reliance on an external binary (`clawtunes`) is transparent and aligned with the skill's stated functionality.
能力评估
Purpose & Capability
Name/description match the required binary and actions. All declared requirements (macOS, clawtunes binary, Apple Music app) are appropriate for controlling Apple Music from the terminal.
Instruction Scope
SKILL.md directs only CLI operations using clawtunes (playback, search, playlists, AirPlay) and briefly notes macOS automation permissions. It does not instruct reading unrelated files, environment variables, or exfiltrating data to external endpoints.
Install Mechanism
Install uses Homebrew with a third‑party tap (forketyfork/tap) and formula 'clawtunes'. This is expected for an external CLI but third‑party taps can install arbitrary code — verify the tap/formula and source (GitHub repo) before installing.
Credentials
No environment variables, credentials, or config paths are requested. The absence of secrets is proportionate to the skill's stated purpose.
Persistence & Privilege
Skill is not 'always: true' and does not request persistent system-wide changes. It may prompt for macOS Automation permission to control Apple Music (normal for this use-case). Agent autonomous invocation is enabled by default but is not unusual.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install clawtunes
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /clawtunes 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.3.1
Clarified installation instructions: pip is not supported, brew is a one-liner.
v0.3.0
Added playlist management commands, Apple Music search, --non-interactive and --first flags
v0.1.0
Initial release of clawtunes Apple Music management skill. - Control Apple Music on macOS through the `clawtunes` CLI. - Play songs, albums, or playlists; interactive menu for multiple matches. - Manage playback (pause, resume, next/previous track, show status), volume (set, adjust, mute), shuffle, and repeat. - Search for music and playlists directly via command line. - Love or dislike tracks, list and manage playlists. - Connect to and control AirPlay audio devices. - Requires macOS and the Apple Music app; Homebrew and pip installation supported.
元数据
Slug clawtunes
版本 0.3.1
许可证
累计安装 3
当前安装数 3
历史版本数 3
常见问题

clawtunes 是什么?

Control Apple Music on macOS via the `clawtunes` CLI (play songs/albums/playlists, control playback, volume, shuffle, repeat, search, catalog lookup, AirPlay... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2403 次。

如何安装 clawtunes?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install clawtunes」即可一键安装,无需额外配置。

clawtunes 是免费的吗?

是的,clawtunes 完全免费(开源免费),可自由下载、安装和使用。

clawtunes 支持哪些平台?

clawtunes 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin)。

谁开发了 clawtunes?

由 forketyfork(@forketyfork)开发并维护,当前版本 v0.3.1。

💬 留言讨论