A powerful CLI utility for discovering and managing USB HID keyboards to control lighting, macros, and hardware profiles.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install claw-keyboard
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install claw-keyboard using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is claw-keyboard?
The claw-keyboard skill provides a robust interface for interacting with USB keyboards that support the vendor HID protocol (UsagePage 0xFF60). As part of the Openclaw Skills ecosystem, it enables AI agents and developers to programmatically control hardware features such as RGB backlighting, custom per-key LED states, and complex macro sequences.
Designed with safety in mind, it allows for deep hardware customization—including key remapping and profile tuning—while requiring explicit user confirmation for destructive actions. This makes it an essential tool for users looking to automate their workspace environment or manage specialized hardware like the LUXSWH R68pro.
claw-keyboard Use Cases
- Automating RGB lighting transitions based on time of day or system status.
- Managing and deploying custom keymaps across multiple layers for productivity.
- Programming complex hardware-level macros for gaming or professional workflows.
- Visualizing keyboard layouts by rendering KLE JSON files into SVG format.
- Tuning hardware parameters like debounce time and sleep settings for optimal performance.
How claw-keyboard Works
- The tool initiates a discovery scan for connected USB HID interfaces matching specific UsagePage and Usage IDs.
- A challenge-response handshake is performed to verify compatibility with the keyboard hardware.
- The skill sends specific HID reports to the device to query current state (RGB, keymap, or macros).
- Users or AI agents issue commands to modify parameters or trigger hardware actions.
- For persistent changes, the tool sends a flash-write command to save configurations to the device's onboard memory.
claw-keyboard Setup
To integrate this into your environment, download the appropriate binary for your OS and ensure it is in your PATH.
# Discover connected devices
claw-keyboard discover
# On Linux, configure udev rules for non-root access
echo 'SUBSYSTEM=="hidraw", ATTRS{idVendor}=="1a86", MODE="0666"' | sudo tee /etc/udev/rules.d/99-claw-keyboard.rules
sudo udevadm control --reload-rules
On macOS, ensure Input Monitoring permissions are granted in System Settings for the terminal or agent execution environment.
claw-keyboard Data Schema & Taxonomy
The claw-keyboard skill interacts with keyboard memory and local files using the following structures:
| Data Type | Description | Format |
|---|---|---|
| Keymap | 2-byte HID key values mapped to grid positions | Hexadecimal (e.g., 0029) |
| Macros | Sequences of keyboard actions | Action strings (tap, press, release, delay) |
| RGB State | Lighting parameters | Hue (0-255), Effect (0-20), Speed (0-5) |
| KLE Layout | External layout definitions | JSON to SVG rendering |
| Profiles | Hardware timing and power settings | Debounce, TAP, Sleep, Power-down |
claw-keyboard Advanced Features
- Multi-device targeting using unique hardware paths via the --device flag.
- Real-time LED synchronization where the keyboard reports live lighting data to the PC.
- Multi-layer keymap management allowing for complete hardware-level rebinds.
- Machine-readable JSON output mode for seamless integration into larger Openclaw Skills automation pipelines.
- Direct flash memory manipulation for permanent, software-independent settings.
SKILL.md
Loading
Related Openclaw Skills
Fantasy & Magic Style Transform (Seedance 2.0)
A specialized AI video generation skill that transforms mundane footage or text prompts into ritual-rich, fantastical vertical shorts using the Seedance 2.0 model.
Web Automation Suite
A comprehensive automation toolkit integrating web scraping, browser manipulation, and scheduled tasks via Chrome CDP.
LiDAR Reference
A specialized technical reference for processing 3D point cloud data and configuring LiDAR scanning systems.
Amazon Pricing Strategy
An intelligent pricing co-pilot for Amazon sellers to maximize Buy Box wins and profit margins through data-driven repricing rules.
Maybe Finance
A comprehensive personal finance management skill that integrates Openclaw Skills with the self-hosted Maybe Finance OS for full control over your financial data.
Animal Content Writer
A specialized content creation skill designed to transform animal behaviors and pet stories into viral, humorous, and high-engagement social media scripts.
Featured*
