skills/sonoscli/SKILL.md

metadata

name: sonoscli
description: Control Sonos speakers (discover/status/play/volume/group).
homepage: https://sonoscli.sh
metadata:
  openclaw:
    emoji: 🔊
    requires:
      bins:
        - sonos
    install:
      - id: go
        kind: go
        module: github.com/steipete/sonoscli/cmd/sonos@latest
        bins:
          - sonos
        label: Install sonoscli (go)

Sonos CLI

Use sonos to control Sonos speakers on the local network.

Quick start

• sonos discover
• sonos status --name "Kitchen"
• sonos play|pause|stop --name "Kitchen"
• sonos volume set 15 --name "Kitchen"

Common tasks

• Grouping: sonos group status|join|unjoin|party|solo
• Favorites: sonos favorites list|open
• Queue: sonos queue list|play|clear
• Spotify search (via SMAPI): sonos smapi search --service "Spotify" --category tracks "query"

Notes

• If SSDP fails, specify --ip <speaker-ip>.
• Spotify Web API search is optional and requires SPOTIFY_CLIENT_ID/SECRET.