A robust command-line interface for discovering, controlling, and grouping Sonos speakers within your local network.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sonos
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install sonos using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is sonoscli?
sonoscli is a developer-centric tool designed to interface with Sonos audio systems directly from the terminal. As part of the ecosystem of Openclaw Skills, it allows for seamless automation of home or office audio environments. Whether you need to adjust volume, toggle playback, or manage complex speaker groups, this skill provides a stable and scriptable interface to interact with your hardware without relying on the official mobile application.
The utility excels at managing multi-room audio setups by providing direct access to the Sonos UPnP and SMAPI protocols. By incorporating this into your local automation workflows, you can create sophisticated audio triggers based on system events or time-based schedules.
sonoscli Use Cases
- Automating morning playlists to start at a specific volume level.
- Creating 'Focus' or 'Meeting' modes that automatically pause all speakers across the network.
- Scripting multi-room audio transitions by grouping or ungrouping speakers dynamically.
- Quick speaker status checks directly from the command line during development sessions.
How sonoscli Works
- The tool initiates a discovery phase using SSDP to locate all Sonos-compatible devices on the local subnet.
- Users target specific speakers using the
--nameflag or by providing a direct IP address for faster access. - Commands are dispatched to the speaker's internal API to modify state, such as transport controls (play/pause) or rendering controls (volume).
- For grouping tasks, the skill coordinates with the master speaker to join or unjoin secondary units in the topology.
sonoscli Setup
To use this within your collection of Openclaw Skills, ensure you have Go installed, then run the following command:
go install github.com/steipete/sonoscli/cmd/sonos@latest
To verify the installation and find your devices:
sonos discover
Note: If your network configuration prevents SSDP discovery, you can target speakers directly using their IP addresses with the --ip flag.
sonoscli Data Schema & Taxonomy
The skill interacts with Sonos hardware and optionally external music services. The primary data inputs and outputs follow this structure:
| Command Category | Key Parameters | Description |
|---|---|---|
| Playback | play, pause, stop |
Controls the transport state of a specific speaker. |
| Volume | set, up, down |
Manages decibel levels (0-100). |
| Topology | join, unjoin, party |
Manages speaker grouping and multi-room synchronization. |
| SMAPI | search, service |
Queries metadata from services like Spotify (requires API credentials). |
sonoscli Advanced Features
- Party Mode: Instantly group all discovered speakers for synchronized playback across the entire network.
- Spotify SMAPI Integration: Perform deep searches for tracks and albums directly through the Sonos Music API.
- Direct IP Targeting: Bypass discovery latency by communicating directly with known speaker hardware.
- Queue Management: Programmatically list, clear, or play specific tracks from the local speaker queue.
SKILL.md
Loading
Related Openclaw Skills
Substack Article Formatter
A technical formatting tool that converts plain text into Substack-optimized HTML for seamless copy-pasting.
Figma Design Analysis & Export
A professional-grade Figma integration for programmatically analyzing design systems, auditing WCAG compliance, and automating multi-format asset exports.
Figma Design Analysis & Asset Export
A professional-grade Figma integration for automated design system analysis, multi-format asset export, and comprehensive WCAG accessibility auditing.
Context Compressor
An automated context management tool that intelligently compresses conversation history to maintain AI agent performance during long coding sessions.
GRVT Exchange CLI
A professional-grade command-line interface and Node.js library for trading perpetuals, futures, and options on the GRVT exchange.
Paperless-ngx
A specialized document management skill for interacting with Paperless-ngx to search, upload, and organize digital archives via API.
Featured*
