Agent Skills
› espressif/esp-claw
› ble_hid
ble_hid
GitHub控制ESP-Claw设备作为BLE HID外设，支持启动广播及发送媒体、键盘（按键/组合键/文本）和鼠标操作。
Trigger Scenarios
用户要求启动BLE HID功能
需要模拟键盘输入或鼠标移动点击
需要发送媒体控制指令
Install
npx skills add espressif/esp-claw --skill ble_hid -g -y
SKILL.md
Frontmatter
{
"name": "ble_hid",
"metadata": {
"cap_groups": [
"cap_lua"
],
"manage_mode": "readonly"
},
"description": "Operate ESP-Claw BLE HID: start HID advertising and send media\/keyboard\/mouse actions."
}
BLE HID
Use this skill whenever the user asks to start BLE HID, make the device show up as a keyboard/mouse/media-control device, send media controls, type keys/text, or move/click/scroll the mouse.
Start BLE HID
{"path":"{CUR_SKILL_DIR}/scripts/start_ble_hid.lua","args":{"name":"esp-claw-hid"},"timeout_ms":10000}
BLE HID is a composite device. Media, keyboard, and mouse reports are all
available at the same time; the action type decides which report is sent.
Send One Action
Media:
{"path":"{CUR_SKILL_DIR}/scripts/send_ble_hid_action.lua","args":{"type":"media","key":"play_pause"},"timeout_ms":5000}
Keyboard key:
{"path":"{CUR_SKILL_DIR}/scripts/send_ble_hid_action.lua","args":{"type":"keyboard_key","key":"SPACE"},"timeout_ms":5000}
Keyboard combo:
{"path":"{CUR_SKILL_DIR}/scripts/send_ble_hid_action.lua","args":{"type":"keyboard_combo","keys":["CTRL","C"]},"timeout_ms":5000}
Text:
{"path":"{CUR_SKILL_DIR}/scripts/send_ble_hid_action.lua","args":{"type":"keyboard_text","text":"hello"},"timeout_ms":5000}
Mouse:
{"path":"{CUR_SKILL_DIR}/scripts/send_ble_hid_action.lua","args":{"type":"mouse_move","dx":30,"dy":0},"timeout_ms":5000}
Version History
- 06eb576 Current 2026-07-24 19:54
