BluCLI — OpenClaw Skill
Control Bluesound and NAD players from your OpenClaw agent -- discover, play, group, and adjust volume.
What This Skill Does
The BluCLI skill gives your OpenClaw agent control over Bluesound and NAD players running BluOS. Using the blu CLI, your agent can discover devices on the local network, check playback status, control play/pause/stop, adjust volume, manage speaker groups for multi-room audio, and search and play TuneIn radio content.
Device targeting follows a priority system: the --device flag (by ID, name, or alias), then the BLU_DEVICE environment variable, and finally any configured default. This makes it easy to control specific speakers or set up a default for hands-free operation. All commands support --json output for scripted workflows.
This is a natural companion to other smart home skills like SonosCLI and Eightctl, giving your AI agent the ability to manage high-fidelity audio playback across your Bluesound ecosystem. Tell your agent to play internet radio, group speakers for a party, or quietly lower the volume when you start a meeting.
Example Prompts
What Bluesound devices are on the network? List them all
Play some classical music on the Living Room speaker
Set the volume on the Bedroom player to 15
Pause playback on all Bluesound devices
Search TuneIn for "BBC Radio 4" and play it on the Kitchen speaker
What's currently playing on the Office NAD amplifier?
Group the Kitchen and Dining Room speakers together
Requirements
Binary dependency: blu must be installed and available in PATH.
- Install via Go:
go install github.com/steipete/blucli/cmd/blu@latest - Network access: The agent must be on the same local network as your Bluesound/NAD players
Setup on KiwiClaw
BluCLI requires local network access to communicate with your Bluesound speakers, so it works best with the KiwiClaw Chrome Extension bridge. Configure the extension in your KiwiClaw dashboard to route commands through your local machine.
Setup Self-Hosted
- Install the blu CLI:
go install github.com/steipete/blucli/cmd/blu@latest - Discover devices:
blu devices - Optionally set a default device:
export BLU_DEVICE="Living Room" - Test:
blu status
Related Skills
- SonosCLI -- similar speaker control for Sonos systems
- Eightctl -- smart home control for Eight Sleep pods
- Sag -- generate TTS audio to play on your Bluesound speakers
- Songsee -- visualize audio being played on your speakers
FAQ
What devices does BluCLI support?
BluCLI supports any device running BluOS, including Bluesound speakers (Node, Pulse, Powernode), NAD amplifiers with BluOS modules, and other BluOS-compatible hardware from brands like DALI and Monitor Audio.
How does BluCLI select which device to control?
BluCLI uses a priority system: first the --device flag (by ID, name, or alias), then the BLU_DEVICE environment variable, and finally any configured default device. Run blu devices to discover available players on your network.
Can BluCLI search and play internet radio?
Yes. BluCLI includes TuneIn integration. Use blu tunein search "query" to find radio stations and blu tunein play "query" to start playback directly.
Does BluCLI support speaker grouping?
Yes. Use blu group status to see current groups, blu group add to add a device to a group, and blu group remove to ungroup a device. This enables multi-room audio across your BluOS players.