键盘鼠标未被识别需依次检查：一、系统是否正确枚举HID设备；二、Linux下用户是否加入input组并获/dev/input/event*读取权限；三、openclaw是否启用hid-input插件；四、Windows是否配置HID服务为自动启动并重启。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜如果您在使用openclaw AI 时发现键盘或鼠标设备未被识别，可能是由于系统级设备枚举失败、权限不足或 openclaw 的输入事件监听模块未启用所致。以下是解决此问题的步骤：
一、验证键盘鼠标是否被操作系统正确识别
openclawAI 依赖内核对 HID 设备（如 USB 键盘、鼠标）的标准枚举结果，若设备未出现在系统设备树中，则无法进入后续处理流程。
1、在 Linux/macOS 终端执行lsinput（需安装 input-utils）或cat /proc/bus/input/devices，查找包含 “Handlers=kbdd mouse” 或 “Name=” 后含 “keyboard”、“mouse” 字样的条目。
2、在 Windows 上打开“设备管理器”，展开“人体学接口设备（HID）”，确认无黄色感叹号；右键设备属性 → “详细信息”选项卡 → 查看“硬件 ID”，确认存在HID\VID_XXXX&PID_YYYY格式标识。
3、对 Linux 用户，插拔设备后运行dmesg | tail -15，检查是否有hid-generic 0003:XXXX:YYYY.XXX: input,hidrawX: USB HID v1.11 Keyboard [Brand Name]类似成功挂载日志。
二、授予 openclaw 对输入设备节点的读取权限
Linux 系统下，/dev/input/event* 设备节点默认仅允许 root 或 input 组成员访问；若 openclaw 以普通用户身份运行且未加入该组，将静默跳过所有输入设备扫描。
1、执行
ls -l /dev/input/event*，记录权限列末尾的组名（通常为input）。
2、运行
sudo usermod -a -G input $USER将当前用户加入 input 组。
3、退出当前会话并重新登录（或重启系统），再执行
groups命令确认 output 中已包含input。
三、启用 openclaw 的 HID 输入事件监听插件
自 2026 年起，openclaw 默认禁用低层级 HID 事件捕获模块，以降低非交互场景下的资源开销；键盘鼠标识别功能必须显式激活对应插件才能生效。
OpenClaw开源的自托管AI智能体助手，曾用名Clawdbot、Moltbot下载
1、运行
openclaw plugins list | grep hid-input，确认输出中hid-input插件状态为disabled或未列出。
2、执行
openclaw plugins enable hid-input启用该插件。
3、重启服务：运行
openclaw stop && openclaw start，随后执行openclaw hardware detect --type keyboard,mouse --verbose查看探测日志中是否出现设备路径与能力描述。
四、检查 Windows 平台 HID 访问策略限制
Windows 默认阻止非管理员进程直接读取原始 HID 输入流，openclaw 在非提升权限下无法调用 ReadFile() 读取 /dev/hidraw* 等等效句柄，需修改注册表解除策略。
1、以管理员身份运行 PowerShell。
2、执行命令：
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Services\HidServ" -Name "Start" -Value 2 -Type DWORD，确保 HID 服务设为自动启动。
3、执行命令：
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Services\Wdf01000" -Name "Start" -Value 3 -Type DWORD，启用通用驱动框架支持。
4、重启系统后，运行
openclawrun --list-input-devices验证输出是否包含 VID/PID 及设备名称。