← 返回 Skills 市场
Clawtunes Play
作者
S K Aravind
· GitHub ↗
· v1.0.3
· MIT-0
84
总下载
1
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install clawtunes-play
功能描述
Play Apple Music songs on macOS using clawtunes, including streaming catalog tracks via a practical keyboard-navigation workaround after opening the song in...
使用说明 (SKILL.md)
Clawtunes Play
Use clawtunes as the first choice for Apple Music control on this Mac.
Workflow
- For library items, try direct playback first.
- For songs likely not in the library, search the Apple Music catalog and open the selected result in Music.
- For catalog playback, prefer the wrapper script that tries the best-known keyboard sequence automatically:
Tab+Tab+Enter- fallback:
Tab+Enter - fallback:
Shift-Tab+Enter
- Check whether playback actually changed to the requested song.
- If playback did not switch, say so plainly.
Commands
- Direct library-style play:
clawtunes_play --song "\x3Csong>"
- Catalog play wrapper:
catalog_play "\x3Cquery>"
- Status only:
clawtunes_play --status
- Experimental step-by-step catalog workflow:
catalog_play_experiment "\x3Cquery>" --index 1 --strategy tab-tab-enter
Requirements
This skill assumes these local tools are available on macOS:
clawtunespython3osascriptopen
It also needs macOS Accessibility / Automation permission so System Events can send keyboard input to Music.
Install / Use
- Keep repo in
skills/clawtunes-play - Commands:
clawtunes_play,catalog_play,catalog_play_experiment - For catalog playback, use the wrapper script in
scripts/catalog_play_wrapper.sh
Notes
clawtunes play songtargets library playback.clawtunes catalog searchopens the streaming result in Music, but Music may not autoplay unless the UI focus lands correctly.- The current best-known workaround is keyboard navigation after opening the result.
- This is macOS UI-state dependent; it is usable, but not a guaranteed Apple primitive.
安全使用建议
This skill appears to do what it says: it searches Apple Music (itunes.apple.com), opens tracks in the Music app, and simulates keyboard input via AppleScript/System Events. Before installing, verify you trust the source (homepage unknown), confirm you have or want to grant macOS Accessibility/Automation permission (this allows simulated keypresses), and ensure the local 'clawtunes' utility is legitimate. You can test safely by running the included scripts manually from a shell to observe their behavior (they print JSON results). If you are uncomfortable with autonomous invocation, avoid enabling the skill to run without your explicit prompt. Finally, review the scripts yourself to confirm no local modifications were made to target processes beyond Music.
功能分析
Type: OpenClaw Skill
Name: clawtunes-play
Version: 1.0.3
The skill utilizes high-risk capabilities including UI automation via `osascript` and `System Events` to inject keystrokes (e.g., Tab, Enter, Cmd+L) into the macOS Music app, which requires Accessibility permissions. It also performs network requests to the iTunes API (`itunes.apple.com`) and executes shell commands via `subprocess` to interact with the `clawtunes` CLI. While these actions are aligned with the stated purpose of automating Apple Music playback and catalog navigation, the use of keystroke simulation and shell execution represents a significant privilege level and attack surface. Key files: `catalog_play.py`, `playlist_create.py`, and `SKILL.md`.
能力评估
Purpose & Capability
Name/description match the implementation: scripts call clawtunes, osascript, and open to control the Music app, and they query the iTunes Search API to find catalog tracks—these are all necessary for the described functionality.
Instruction Scope
SKILL.md describes the exact local commands and macOS permissions the scripts use. The runtime instructions and scripts only access the Music app, local utilities (clawtunes, osascript, open, python3), and the iTunes search endpoint; they do not read unrelated files or environment variables.
Install Mechanism
No install spec or remote download is used; the skill is distributed as code included in the bundle. It runs local Python scripts and a small wrapper shell script—no external package downloads or archive extraction were observed.
Credentials
The skill requests no environment variables or credentials. It does use macOS Accessibility/Automation permissions (necessary for sending keyboard events) and network access to itunes.apple.com for search results—both are proportionate to the stated purpose.
Persistence & Privilege
The skill uses default invocation settings (not always:true). It can be invoked autonomously per platform defaults; this is normal but be aware it will run local commands and send keyboard events when invoked.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install clawtunes-play - 安装完成后，直接呼叫该 Skill 的名称或使用
/clawtunes-play触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.3
Add install notes and requirements
v1.0.2
Add requirements and install notes for macOS music control
v1.0.1
Make paths portable and update usage docs
v1.0.0
Clarify Mac Apple Music app support and catalog search/play
元数据
常见问题
Clawtunes Play 是什么？
Play Apple Music songs on macOS using clawtunes, including streaming catalog tracks via a practical keyboard-navigation workaround after opening the song in... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 84 次。
如何安装 Clawtunes Play？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install clawtunes-play」即可一键安装，无需额外配置。
Clawtunes Play 是免费的吗？
是的，Clawtunes Play 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Clawtunes Play 支持哪些平台？
Clawtunes Play 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Clawtunes Play？
由 S K Aravind（@skaravind）开发并维护，当前版本 v1.0.3。
推荐 Skills