OpenClaw快捷键未生效需检查全局监听是否启用或配置是否正确，可通过内置界面、编辑config.yaml、PowerToys桥接或Skill内嵌registerHotkey()四种方式配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在使用 openclaw（“小龙虾”）过程中快速触发特定动作或 skill，但当前未配置快捷键，则可能是由于系统未启用全局热键监听或快捷键未在配置中正确注册。以下是实现快捷键绑定的多种可行路径：一、通过 OpenClaw 内置快捷键配置界面设置
OpenClaw 提供图形化快捷键管理入口，支持为已安装的 Skill 或自定义命令分配组合键，无需修改代码即可生效。
1、启动 OpenClaw 控制面板：在终端执行 openclaw dashboard，等待 WebUI 在浏览器中打开。
2、点击左侧导航栏中的 快捷键（Hotkeys） 选项卡。
3、点击右上角 + 添加快捷键 按钮。
4、在弹出表单中填写：触发组合键（如 Ctrl+Alt+L）、目标 Skill 名称（如 “截图识字” 或 “微信消息转发”）、执行模式（同步/异步）。
5、点击 保存，系统将自动注入全局监听器并提示“快捷键已激活”。
二、通过编辑 config.yaml 手动注入热键映射
该方式适用于需要精确控制触发逻辑、绑定非标准组合键（如 Win+Shift+Q）或批量配置多个快捷键的进阶用户。配置直接写入主配置文件，重启网关后持久生效。
1、定位配置文件路径：在终端运行 openclaw config --show-path，复制输出的完整路径。
2、用文本编辑器（如 VS Code 或 Notepad++）以管理员权限打开该 config.yaml 文件。
3、在文件末尾新增 hotkeys: 区块，格式如下：
hotkeys:
- key: "ctrl+alt+q"
action: "skill:clipboard-translate"
- key: "win+shift+s"
action: "command:screen-capture"
4、保存文件，关闭编辑器。
5、在终端执行 openclaw gateway restart 使新配置加载。
三、利用 Windows PowerToys 或 AutoHotkey 实现外部热键桥接
当 OpenClaw 原生热键监听因系统权限或焦点冲突失效时，可借助第三方工具生成模拟 HTTP 请求，绕过内置监听模块直接调用 OpenClaw API 接口。
1、确保 OpenClaw 网关已启动且 WebUI 可访问，记录面板 URL 中的 token（形如 ?token=abc123...）。
2、安装 PowerToys（Windows 官方工具），打开 Settings → Keyboard Manager → Remap a shortcut。
3、点击 + 新建映射，将物理按键（如 Alt+X）映射为“打开 URL”操作。
4、URL 填写格式为：http://127.0.0.1:18789/api/v1/skill/trigger?name=wechat-forward&token=abc123...。
5、测试按下组合键，观察 OpenClaw 终端是否输出对应 Skill 的执行日志。
四、在 Skill 脚本内嵌 registerHotkey() 方法（开发者级）
适用于自行开发或二次修改 Skill 的用户。通过调用底层 Node.js 的 robotjs 或 globalShortcut 模块，在 Skill 初始化阶段主动注册系统级热键，具备最高优先级和最低延迟。
1、进入 Skill 工作区目录：cd ~/.openclaw/workspace/skills/your-skill-name。
2、编辑 index.ts（或 index.js），在 export default 函数顶部添加：
if (process.platform === 'win32') {
const { globalShortcut } = require('electron');
globalShortcut.register('Ctrl+Shift+K', () => {
main();
});
}
3、保存后执行 openclaw skill reload your-skill-name 重新加载该 Skill。
4、验证：切换至任意窗口，按下 Ctrl+Shift+K，Skill 应立即响应。
