sonoscli

What This Skill Does

The sonoscli is a powerful OpenClaw agent skill designed to bridge the gap between your digital AI assistant and your home audio ecosystem. It provides a command-line interface to interact directly with Sonos speakers on your local network. Whether you are looking to manage playback, adjust volume levels across different zones, or explore your curated music library, this skill offers granular control. It supports device discovery via SSDP, grouping logic for multi-room audio, and integration with music services like Spotify to ensure your smart home remains perfectly synced with your preferences.

Installation

To integrate this skill into your environment, use the OpenClaw hub command. Ensure you have the necessary network permissions configured for your agent to communicate across your local subnet.

Command: clawhub install openclaw/skills/skills/ahmadshouly/sonoscli-bak

Use Cases

• Whole-Home Audio Management: Instantly group speakers for a party mode or isolate specific zones during quiet hours.
• Music Discovery: Quickly search and play tracks from connected services like Spotify without leaving your command line interface.
• Automated Playback: Integrate with home automation routines to stop music when you leave the house or resume a specific queue when you return.
• Status Monitoring: Check which speakers are currently active or identify the status of your current queue to ensure consistency across the house.

Example Prompts

1. "Sonos, find all speakers on my network and set the volume in the Kitchen to 20%."
2. "Could you group the Living Room and Kitchen speakers together and play my current Spotify queue?"
3. "Pause the music in the Master Bedroom and tell me what is currently playing in the Office."

Tips & Limitations

• Network Reliance: The skill relies on SSDP (Simple Service Discovery Protocol). If your router blocks multicast traffic, you must use the --ip flag to manually define your speaker's address.
• Spotify Integration: While basic controls work out-of-the-box, full Spotify search functionality requires setting your SPOTIFY_CLIENT_ID and SPOTIFY_CLIENT_SECRET environment variables.
• Latency: Audio control commands are subject to local network latency; do not expect instantaneous response times if your network is heavily congested. Always prioritize stable Wi-Fi connections for your Sonos devices for the best experience.