Agent Skills
› espressif/esp-claw
› ble_hid
ble_hid
GitHub控制ESP-Claw BLE HID设备，使其模拟键盘、鼠标或媒体控制器。支持启动广播及发送按键、组合键、文本输入和鼠标移动点击等操作。
触发场景
用户要求启动BLE HID功能
需要发送键盘按键或组合键
需要模拟鼠标移动或点击
需要发送媒体控制指令
安装
npx skills add espressif/esp-claw --skill ble_hid -g -y
SKILL.md
Frontmatter
{
"name": "ble_hid",
"metadata": {
"cap_groups": [
"cap_lua"
]
},
"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}
版本历史
- 36b377f 当前 2026-11-02 21:37
- 06eb576 2026-07-24 19:54
