🎵 Sonos Control Hub

Hardware IoT · Smart Home · Smart Speaker

Let AI's hands reach into the physical world! Grant your agent the ability to directly control Sonos multi-room audio systems via local network — ditch the complicated app interfaces and official controllers entirely.

OpenClaw Team

🚀 Quick Install

Run the following command in your terminal to install:

npx clawhub install sonoscli

📊 Stats Overview

⭐ Stars	☁️ Total Calls	👥 Active Users	🎯 Stable Version
204	15.6k	450	v0.9.1

🎛️ How It Works

This skill is the first bridge connecting AI to physical hardware (Smart Home). No expensive third-party gateways needed — it runs entirely with Node.js local privileges:

📡 UDP Auto Device Discovery: As long as it runs on the same LAN or Wi-Fi network, the underlying driver automatically initiates multicast handshakes, scanning all online Sonos speakers and system groups in the network, and mapping a virtual topology.
🎚️ Sub-second Command Delivery: All commands (play/pause, volume control, track skipping) go directly to the device's internal firmware without routing through WAN or Sonos cloud. This means AI responds to human audio intents in just 50-100 milliseconds.
🌐 Room-level Matrix Orchestration: The toolset includes built-in zone selection. The Agent can not only control global Party Mode, but also precisely target specific bedrooms or living rooms for specialized audio control.
📚 Media Library Deep Integration: Supports direct browsing of LAN NAS services, streaming services like Spotify, and cross-pool resource playback queue management.

🧭 Typical Use Cases

🔔 Scenario 1: Smart Security Alert & Broadcast Relay

Combined with other smart tool chains, when AI detects "back door opened unusually late at night" or "heavy rain approaching" via cameras (using vision capabilities) or scheduled sensors — the model immediately invokes this skill: force-removes Sonos's silent sleep mode, sets all rooms to 60% volume, and loudly announces the emergency situation.

🎭 Scenario 2: Immersive Context-aware Music Switching

For WFH tech enthusiasts: leverage the language model to craft your ultimate workflow. Tell the Agent: "We're about to deep-focus on a long coding session." Besides enabling your editor's focus mode, the model simultaneously mounts sonoscli, sets all rooms to low volume, and auto-plays the Lo-Fi Coding white noise playlist — maximizing work ritual vibes.

💻 Command Reference

After installation, you can let AI call these autonomously via conversation, or manually trigger operations from the CLI:

Auto-discover and list all available Sonos hardware and room groups in your home:

clawhub execute sonoscli action="discover"

Set a specific working volume for the Master Bedroom:

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

Take over the current music queue and skip to next track:

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

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

🛡️ Requirements & Network Limitations

🌐 Same-subnet Requirement: The tool's underlying mechanism uses UPnP and SOAP protocol encapsulation. Ensure the Agent's host (e.g., your Raspberry Pi or laptop) and all Sonos speakers are on the same virtual subnet/VLAN (cannot cross network NAT firewalls).
✅ Fully Offline Experience: Good news — this capability completely eliminates the nightmare of registering with Sonos's official App and requesting tokens. This means it works perfectly on a pure internal network even without internet access.

🔗 View Source on GitHub