🎵 Sonos 控制台中枢

硬件互联 · 家庭物联网 · 智能音响

让 AI 的手真正伸出现实世界！赋予智能体直接调用本地局域网控制 Sonos 多房间音频系统矩阵的能力，彻底抛弃繁杂的 App 页面与官方控制器。

OpenClaw Team

🚀 快速安装

在您的终端中执行以下命令即可完成安装：

npx clawhub install sonoscli

⭐ 收藏点赞	☁️ 总计调用	👥 当前活跃	🎯 稳定版本
204	15.6k	450	v0.9.1

本技能是连接 AI 与物理硬件（Smart Home）的第一座桥梁。不需要依赖外部昂贵的三方网关，它完全以 Node.js 的本地特权运转：

📡 UDP 全自动设备嗅探：只要运行在同一个局域网（LAN）或 Wi-Fi 下，底层驱动会自动发起多路广播握手，扫出网络内所有在线的 Sonos 实体音响与系统编组，并绘制虚拟拓扑图。
🎚️ 亚秒级的指令直通：所有指令（播放/暂停、音量极值设定、音轨跨域步进）均由于不需要流经广域网与 Sonos 云端，直接抵达设备内网固件。这意味着 AI 响应人类音频意图的速度仅在 50~100 毫秒之间。
🌐 房间级矩阵分离编排：工具集内置了区域（Zone）选择。Agent 不仅能操控全局的派对模式（Party Mode），还能非常精细化地只针对某个卧室或是客厅执行特殊的声浪控制。
📚 音媒库强耦合：支持直接检索局域网 NAS 服务、流媒体 Spotify 等跨池库进行资源播放排队（Queue）控制。

结合其他的智能工具链，当 AI 通过摄像头（接入其视觉能力）或是定时传感器捕捉到"深夜后门异常打开"或是"即将下暴雨"的数据状态后，模型可以立即组合调用该技能：强行解除 Sonos 原本的静音睡眠模式，将全量房间的音量调至 60%，并把紧急情况大声播放出来。

对于在家办公的极客：您可以利用语言模型打造您的终极工作流。对 Agent 说："我们要开始集中精力肝一份长条代码了。" 模型除了帮您开启编辑器的专注模式外，还会同时挂载 sonoscli，将所有房间设定为轻音量，并自动播放 Lo-Fi Coding 的白噪音播放列表，拉满工作仪式感。

安装完成后，您不仅可以通过对话让 AI 自主调用，还可以在 CLI 侧手动发起操作：

自动全网探索并列出您家中的所有可用 Sonos 硬件及房间分组名称：

clawhub execute sonoscli action="discover"

定向对主卧（Master Bedroom）设置特定大小的工作音量：

clawhub execute sonoscli action="volume" room="Master Bedroom" level=25

接管正在播放的音乐队列，执行跨曲与换端命令：

clawhub execute sonoscli action="next" room="Living Room"

clawhub execute sonoscli action="play" room="Dining Room" url="spotify:track:xxxx"

🌐 同网段隔离要求：工具的底层原理是 UPnP 与 SOAP 协议的封装，使用时请绝对确保执行 Agent 的宿主（例如您的树莓派或笔记本）与所有的 Sonos 音响处于同一虚拟子网/VLAN（无法跨越网络 NAT 防火墙）。
✅ 完全离线体验：好消息是，该能力彻底摒弃了向 Sonos 官方注册 App 及索取 Token 的恶梦级步骤；这代表即便断开国际互联网，纯内网依然奏效。