Bluetooth

What This Skill Does

The Bluetooth skill for OpenClaw empowers your AI agent to discover, interact with, and manage local Bluetooth devices seamlessly. It acts as an abstraction layer across major operating systems (Linux, macOS, and Windows), allowing the agent to handle low-level connection protocols like GATT and RFCOMM without requiring manual intervention from the user. The skill follows a rigorous five-step workflow: scanning for nearby hardware, identifying device signatures, establishing secure connections, executing operational commands, and continuously learning from interactions to refine device profiles. By maintaining a structured workspace at ~/bluetooth/, the agent keeps track of known device configurations, interaction history, and pending discovery tasks, ensuring a persistent and reliable experience for all linked peripherals.

Installation

To integrate this skill into your environment, use the OpenClaw Hub CLI. Ensure that your system has the necessary Bluetooth drivers and library dependencies (such as BlueZ for Linux or native Bluetooth stacks for macOS/Windows) installed beforehand. Execute the following command in your terminal:

clawhub install openclaw/skills/skills/ivangdavila/bluetooth

Once installed, the agent will initialize the ~/bluetooth/ directory structure upon the first request to interact with a device.

Use Cases

• Smart Home Integration: Automatically toggle smart lights or locks when you enter a room.
• Peripheral Management: Configure and control custom Bluetooth-enabled sensors or input devices used in your development workflow.
• Proximity Automation: Trigger specific scripts or environmental changes when your phone or wearable device is detected nearby.
• Data Acquisition: Regularly poll Bluetooth-enabled diagnostic equipment and log the status to your local history file.

Example Prompts

1. "Scan for nearby devices and create a new profile for the fitness tracker I just turned on."
2. "Check the current battery level of my wireless keyboard using the saved profile and report back."
3. "Attempt to connect to the 'Office_Speaker' and set the volume to 50% using the established Bluetooth workflow."

Tips & Limitations

• Security First: The agent is strictly configured to never auto-connect to unrecognized devices. Always review the pending.md file if a device is discovered but not yet authorized.
• Learning Capabilities: The skill excels when it has enough history. If a command fails, ensure you check history.md to see if the device profile needs manual adjustment.
• Platform Support: While the skill supports cross-platform execution via Bleak, ensure your OS-specific drivers are up to date, especially on Linux, where bluetoothctl performance is highly dependent on BlueZ versions.