venus-ble-vibrator

What This Skill Does

The venus-ble-vibrator skill allows OpenClaw to control Venus (Cachito) BLE vibrators through a natural language interface. By acting as a bridge between the agent's logic and the physical hardware, it enables sophisticated, intent-driven control of the device. This skill leverages the ToyBridge architecture to interface with the macOS CoreBluetooth stack, allowing the agent to set precise vibration intensities, execute complex rhythmic patterns, or stop the device instantly based on conversation context.

Installation

To integrate this skill, ensure your environment meets the hardware prerequisites. First, follow the setup instructions in the ToyBridge repository to discover your device ID and verify your local Bluetooth connectivity. Once the environment is configured, start the bridge server by running uv run 4-bridge/server.py in your terminal. With the server active on port 8888, install the skill into your OpenClaw environment using the command: clawhub install openclaw/skills/skills/amandaclarke61/venus-ble-vibrator. Please note that this skill is exclusively designed for macOS and requires the ToyBridge server to remain active in the background throughout your session.

Use Cases

This skill is perfect for users seeking automated or hands-free control of their Cachito-protocol devices. It is especially useful for integration into "focus" or "relaxation" routines where the agent can manage the device intensity automatically. Developers can also use this to prototype interactive haptic feedback systems, while end-users can leverage it to initiate pre-defined patterns like 'pulse' or 'tease' without manually interacting with controller apps.

Example Prompts

1. "Set the vibrator to a medium intensity of 40%."
2. "Run the tease pattern to start things off slowly."
3. "Stop the device immediately and keep it off."

Tips & Limitations

Be mindful that the skill operates on a 0–100 intensity scale. For safety, always ensure your device is within range of the Mac running the server. If the agent returns a connection error, verify that the server.py process is active and that your macOS system permissions allow Bluetooth access for your terminal. Remember that intensities are clamped: values outside the 0–100 range will be ignored or forced to the nearest boundary. If you are using OpenClaw inside a Docker container, ensure your network configuration correctly maps the host port to allow the agent to reach the bridge server.