A command-line interface for managing Bluetooth connections, audio output routing, and system volume on macOS.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install macos-audio
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 macos-audio 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 macOS Audio Control?
The macOS Audio Control skill provides developers and power users with a programmatic way to interact with the macOS sound system. By leveraging this Openclaw Skills entry, users can automate switching between local speakers, Bluetooth headphones, and AirPlay devices without leaving the terminal or AI agent interface. It acts as a robust bridge between high-level user commands and low-level system utilities, ensuring seamless audio management.
macOS Audio Control Use Cases
- Automating audio output switching when starting specific developer workflows.
- Monitoring system volume levels and mute status through an AI agent interface.
- Connecting to specific Bluetooth devices by MAC address or name without using the GUI.
- Playing notification sounds or background audio files in scripts or automation sequences.
How macOS Audio Control Works
- The skill queries system dependencies like blueutil and switchaudio-osx to interact with macOS hardware and software layers.
- Users or agents invoke the CLI to scan for available Bluetooth, Local, or AirPlay targets available on the system.
- The skill executes connection logic to route audio or sets specific volume levels based on user input or automated triggers.
- Real-time status checks provide immediate feedback on the success of audio routing changes through the Openclaw Skills framework.
macOS Audio Control Setup
To get started with this skill, first install the necessary system dependencies via Homebrew:
brew install switchaudio-osx
brew install blueutil
Then, install the macOS Audio CLI to enable the skill functionality:
brew install vossenwout/tap/macos-audio-cli
macOS Audio Control Data Schema & Taxonomy
The skill interacts with macOS system services and provides structured output via the status command. The data is organized as follows:
| Field | Description |
|---|---|
| output | The name of the current active audio output device |
| volume | Integer representing the system output volume (0-100) |
| mute | Boolean indicating the current mute state of the system |
| type | The connection category, such as Bluetooth, Local, or AirPlay |
macOS Audio Control Advanced Features
- Background audio playback support using the --background flag for non-blocking notifications.
- Machine-readable JSON output for the status command to facilitate integration with other Openclaw Skills.
- Support for connecting to Bluetooth devices via MAC address for high-precision device targeting.
- Granular exit codes (0-4) for programmatic error handling in automated shell scripts or agent workflows.
SKILL.md
Loading
Related Openclaw Skills
Coin Identifier
Identify coins from photos using evidence-based visual checks, ranked candidates, and mint-mark reasoning with a reusable local catalog.
Market Radar
An automated market intelligence analyst that monitors global industry trends and performs deep 5-dimension competitor scans using AI browser agents.
WeChat MP Draft
A specialized tool for programmatically drafting and saving WeChat Official Account articles directly to the platform's draft box.
WeClone Init Twin
A professional scaffolding tool designed to initialize and regenerate markdown-based digital twin persona directories for AI agents.
FT Share A-Share Announcement Data
A specialized tool for retrieving and downloading A-share market announcements and analyst research reports for specific dates or stocks.
PyThesisPlot
A specialized Python workflow designed to automate the transition from raw research data to publication-quality scientific visualizations.
Featured*
