需配置本地热键触发机制：一、修改config.yaml启用内置监听模块；二、用powertoys（win）或karabiner（macos）重映射系统级快捷键；三、autohotkey脚本注入指令（win高级方案）；四、通过日志验证并调试响应延迟。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已安装QClaw并完成微信绑定，但希望摆脱鼠标点击或扫码启动的依赖，直接通过键盘组合快速唤醒AI执行任务，则需配置本地热键触发机制。QClaw当前未在图形界面中提供可视化快捷键设置入口，但支持通过修改本地配置文件与系统级热键注册实现自定义唤醒。以下是具体操作路径：
一、启用QClaw内置热键监听模块
QClaw默认不自动激活全局热键功能，需手动开启底层监听服务。该服务启用后，将接管指定按键组合，避免与其他软件冲突，并确保在任意前台应用下均可响应。
1、关闭正在运行的QClaw主程序（右键任务栏图标→退出）。
2、打开QClaw安装目录下的config.yaml文件（Windows默认路径为C:\Program Files\QClaw\config.yaml，macOS为/Applications/QClaw.app/Contents/Resources/config.yaml）。
3、在文件末尾新增如下两行（注意保持YAML缩进格式，使用空格而非Tab）：
hotkey_enabled: true
hotkey_combination: "Ctrl+Alt+Q"
4、保存文件，重新双击启动QClaw。启动日志中若出现"Hotkey listener initialized: Ctrl+Alt+Q"字样，即表示监听模块已激活。
二、使用PowerToys（Windows）或Karabiner-Elements（macOS）重映射系统级快捷键
当QClaw内置热键因权限限制或焦点问题失效时，可借助系统级工具将任意物理按键组合转发为QClaw可识别的虚拟事件。该方式绕过QClaw自身监听逻辑，稳定性更高，且支持多键无冲突组合。
1、Windows用户前往https://github.com/microsoft/PowerToys/releases下载最新版PowerToys，安装后启动。
2、在PowerToys设置中进入Keyboard Manager → Remap a shortcut，点击“+”号添加新映射。
3、在“Physical Shortcut”中按下您期望的快捷键（如Win+Shift+Z），在“Mapped To”中选择Ctrl+Alt+Q（即QClaw已配置的监听组合）。
4、macOS用户访问https://karabiner-elements.pqrs.org/下载安装Karabiner-Elements，打开后进入“Complex Modifications”→“Add rule”，搜索并启用"Enable command+control+space to trigger QClaw hotkey"规则。
三、通过AutoHotkey脚本注入精准唤醒指令（Windows高级方案）
适用于需动态判断当前上下文（如仅在浏览器中生效）、或需附加预处理动作（如自动复制当前页面URL再发送给QClaw）的场景。该脚本以低层级API调用模拟按键，兼容性优于GUI自动化工具。
1、从https://www.autohotkey.com/download/下载AutoHotkey v2.0安装包并完成安装。
2、新建文本文件，粘贴以下代码并保存为QClaw_Wake.ahk：
^!w:: ; Ctrl+Alt+W触发
SendInput, ^!q
return
3、双击运行该脚本，任务栏将出现绿色H图标；此后按下Ctrl+Alt+W即等效于向QClaw发送其监听的Ctrl+Alt+Q信号。
4、如需开机自启，将该脚本快捷方式放入Windows启动文件夹：shell:startup。
四、验证热键是否生效并调试响应延迟
热键配置成功后，QClaw应在毫秒级内弹出浮动指令输入框。若无响应，需排查系统级拦截或配置错位。该步骤不依赖GUI反馈，直接读取进程行为日志，定位真实瓶颈点。
1、打开QClaw安装目录下的logs\latest.log文件，确保实时监控其内容刷新。
2、按下已配置的热键组合，观察日志末尾是否立即追加一行含"Received hotkey event"字样的记录。
3、若日志有记录但无UI响应，说明QClaw主窗口被最小化或隐藏，执行Ctrl+Alt+Q两次：首次唤醒，第二次强制聚焦主窗口。
4、若日志无任何热键相关输出，检查config.yaml中hotkey_enabled值是否为true（注意大小写与冒号后空格）。
