What problem does it solve?
It solves the need to control devices through standard HID inputs (keyboard, mouse, media keys) without writing a full host-side app, so your ESP32 can behave like a human user.
Core Features & Use Cases
- Start BLE HID advertising: make the device appear as a composite HID peripheral supporting media, keyboard, and mouse actions at once.
- Send media/keyboard/mouse actions: drive media playback controls, type keys or text, and perform mouse movement and clicks.
- Composite report control by action type: choose which HID report is sent by the requested action type (media, keyboard_key, keyboard_combo, keyboard_text, or mouse_move).
Use case example: You need an ESP32 to quickly pause/play media and type a short command sequence on a nearby computer by emulating a keyboard and media controller.
Quick Start
Tell the agent: "Start the ble_hid skill, advertise as a BLE HID device named esp-claw-hid, then send a keyboard combo CTRL+C to trigger the action I need."