sonoscli

What This Skill Does

The sonoscli is a powerful tool designed to integrate your OpenClaw AI agent directly with your Sonos audio ecosystem. It acts as a bridge between your local network and Sonos hardware, allowing for comprehensive control of audio playback, volume management, speaker grouping, and music library interaction. By leveraging the Simple Service Discovery Protocol (SSDP), it can automatically detect available speakers on your local network, enabling seamless automation of your home audio environment without requiring manual IP configuration.

Installation

To integrate this skill into your environment, run the following command in your terminal: clawhub install openclaw/openclaw/skills/sonoscli Ensure that your host machine has the necessary network permissions configured. If running in a sandbox, verify that the environment has explicit access to local UDP traffic for discovery to function correctly.

Use Cases

This skill is ideal for users who want to implement voice-controlled smart home routines. You can automate 'morning playlists' by queuing your favorite tracks upon waking, silence your entire home with a single command when heading out, or dynamically group speakers to ensure synchronized playback during social gatherings. It is also perfect for managing volume levels programmatically based on the time of day or other environmental triggers.

Example Prompts

1. "Find all my Sonos speakers on the network and tell me their current status."
2. "Set the volume of the Kitchen speaker to 20 and start playing my 'Favorites' list."
3. "Create a party group including the Living Room and Kitchen, then play music from Spotify."

Tips & Limitations

For optimal performance, ensure your device is on the same subnet as your Sonos speakers. If discovery fails due to network restrictions, manually provide the speaker's IP address using the --ip flag. Note that on macOS, you must grant the parent process (Terminal or VS Code) 'Local Network' permissions in System Settings. Spotify features are optional and depend on providing valid SPOTIFY_CLIENT_ID and SECRET environment variables. If you encounter 'no route to host' or 'bind: operation not permitted' errors, verify that no restrictive firewalls or container sandboxes are blocking UDP port 1900 or the ephemeral ports required for SSDP discovery. Always prefer running the tool in an environment with sufficient network privileges to avoid connectivity issues.