Sonos CLI：命令行音频控制 - Openclaw Skills

下载入口:https://github.com/openclaw/skills/tree/main/skills/steipete/sonoscli

安装与下载

1. ClawHub CLI

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

npx clawhub@latest install sonoscli

2. 手动安装

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

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

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

3. 提示词安装

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

请帮我使用 Clawhub 安装 sonoscli。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

什么是 Sonos CLI？

Sonos CLI 为通过命令行与 Sonos 音频硬件进行交互提供了全面的界面。Openclaw Skills 的这一技能使用户能够通过简单的命令执行复杂的动作，如扬声器发现、音量调节和播放控制。对于希望将智能家庭音频集成到现有自动化脚本或本地网络管理工具中的开发人员来说，它特别有用。

通过利用 sonos 二进制文件，用户可以弥合开发环境与物理音频设备之间的差距。无论您是需要快速静音扬声器，还是在多个房间设置同步的聚会分组，此工具都能提供 CLI 应用程序的精确度和速度。

Sonos CLI 应用场景

• 根据特定的触发器或时间表自动播放音乐。
• 在开发或专注期间通过程序控制音量和播放。
• 管理多房间扬声器组以实现同步家庭音频。
• 查询扬声器状态以集成到系统监控工具或仪表板中。

Sonos CLI 工作原理

1. 该工具启动使用 SSDP 的发现过程，以查找本地子网上的所有活动 Sonos 扬声器。
2. 用户通过名称或 IP 地址定位特定扬声器，以发布播放或音量命令。
3. CLI 与 Sonos UPnP API 通信以执行播放、暂停或跳过等请求的操作。
4. 对于音乐搜索，该工具利用 SMAPI（Sonos 音乐 API）直接通过命令行浏览 Spotify 等服务。

Sonos CLI 配置指南

要在 Openclaw Skills 工作流中使用此工具，必须安装 Go。运行以下命令安装二进制文件：

go install github.com/steipete/sonoscli/cmd/sonos@latest

安装后，通过运行以下命令验证连接：

sonos discover

如果无法自动找到扬声器，可以使用 --ip 标志直接定位它们。

Sonos CLI 数据架构与分类体系

命令组件	描述
discover	扫描本地网络中的 Sonos 设备
--name	目标扬声器标识符字符串（例如 "Kitchen"）
--ip	用于手动连接的直接 IP 地址
favorites	列出或打开保存的 Sonos 收藏电台
smapi search	通过特定服务提供商执行音乐搜索
queue	用于列出、播放或清除当前队列的管理命令

name: sonoscli
description: Control Sonos speakers (discover/status/play/volume/group).
homepage: https://sonoscli.sh
metadata: {"clawdbot":{"emoji":"??","requires":{"bins":["sonos"]},"install":[{"id":"go","kind":"go","module":"github.com/steipete/sonoscli/cmd/sonos@latest","bins":["sonos"],"label":"Install sonoscli (go)"}]}}

Sonos CLI

Use sonos to control Sonos speakers on the local network.

Quick start

• sonos discover
• sonos status --name "Kitchen"
• sonos play|pause|stop --name "Kitchen"
• sonos volume set 15 --name "Kitchen"

Common tasks

• Grouping: sonos group status|join|unjoin|party|solo
• Favorites: sonos favorites list|open
• Queue: sonos queue list|play|clear
• Spotify search (via SMAPI): sonos smapi search --service "Spotify" --category tracks "query"

Notes

• If SSDP fails, specify --ip <speaker-ip>.
• Spotify Web API search is optional and requires SPOTIFY_CLIENT_ID/SECRET.