bluetooth-monitor

What This Skill Does

The bluetooth-monitor skill provides a comprehensive command-line interface for managing and tracking Bluetooth peripherals on macOS. Acting as a bridge between the system's Bluetooth stack and the user, it allows you to query the status of connected hardware, perform connection management, and monitor essential metrics like battery life. By leveraging the power of blueutil, this skill turns complex system Bluetooth operations into intuitive, actionable commands, making it easier to maintain your hardware environment without navigating system settings menus.

Installation

To integrate this skill into your OpenClaw environment, ensure you have the blueutil CLI installed on your macOS system, as it serves as the underlying driver for this skill. You can install it via Homebrew by running brew install blueutil. Once prerequisites are met, install the skill using the command: clawhub install openclaw/skills/skills/franky0617/bluetooth-monitor.

Use Cases

This skill is ideal for power users who frequently switch between multiple Bluetooth peripherals. Use cases include:

1. Troubleshooting: Quickly identifying if a peripheral has disconnected due to signal interference or power saving.
2. Energy Management: Proactively monitoring the battery levels of your Magic Keyboard, Mouse, or Trackpad to avoid mid-task power failure.
3. Quick Toggles: Instantly toggling Bluetooth power states during flights or when needing to reset a stuck connection without opening System Preferences.
4. Automation: Integrating device status checks into automated workflows where specific hardware availability is required.

Example Prompts

1. "Check if my Magic Keyboard is currently connected and what its battery level is."
2. "I need to reset my Bluetooth connection; please disconnect my trackpad and then reconnect it using address 08-65-18-B9-9C-B2."
3. "List all paired devices and tell me which ones are currently active on my Mac."

Tips & Limitations

• Formatting: Always ensure your device addresses follow the strict XX-XX-XX-XX-XX-XX hyphenated format, as the script is sensitive to separators.
• Compatibility: While the skill provides battery status, legacy Bluetooth devices may not expose this metadata to macOS, which will result in missing battery information for those specific peripherals.
• Environment: This skill is exclusively designed for macOS environments that support the blueutil binary. Ensure your user account has sufficient permissions to control system Bluetooth interfaces.