openclaw热键冲突可按五步解决：一、统一清场所有残留实例；二、禁用输入法等冲突进程热键；三、修改config.json中hotkey字段；四、windows下用openark提升内核优先级；五、清除并重载热键缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 OpenClaw 时发现热键无法触发、响应延迟或被其他程序抢占，则很可能是 OpenClaw Gateway 启动后注册的全局热键与其他进程（如输入法、远程控制工具、游戏辅助软件）发生冲突。以下是多种可立即执行的解决方法：
一、确认当前运行模式并清场
OpenClaw 的热键行为高度依赖其运行模式（系统服务 / PM2 / 独立进程），若多模式共存，会导致热键注册重复或抢占。必须先确保仅有一个入口处于活动状态。
1、执行统一清场命令，清除所有残留实例：
2、运行以下四组命令（建议逐行粘贴至终端）：
openclaw gateway stop 2>/dev/null && openclaw gateway bootout 2>/dev/null
pm2 stop openclaw-gateway 2>/dev/null && pm2 delete openclaw-gateway 2>/dev/null
pkill -f "openclaw gateway" 2>/dev/null && lsof -ti:8765 | xargs kill -9 2>/dev/null
3、验证是否彻底清空：
ps aux | grep -v grep | grep "openclaw gateway"
lsof -i :8765
4、若上述任一命令返回非空结果，说明仍有残留，请重复执行对应清理步骤，直至输出为空。
二、禁用冲突进程的热键注册
OpenClaw 热键（默认为 Ctrl+Shift+Z）可能被输入法（如搜狗、微软拼音）、安全软件（如火绒、360）、或远程桌面工具（如 ToDesk、AnyDesk）劫持。需定位并临时禁用其热键模块。
1、打开 Windows 任务管理器，切换到“启动”标签页，禁用可疑第三方启动项。
2、进入“详细信息”标签页，按 CPU 或名称排序，查找以下典型进程名：
搜狗拼音：SogouPY.exe
微软输入法：ctfmon.exe（注意：禁用前请确认非系统必需）
火绒：hrb.exe
ToDesk：ToDesk_Service.exe
3、对疑似进程右键选择“结束任务”，随后立即测试 OpenClaw 热键是否恢复。
4、若确认某进程为冲突源，进入其设置界面，关闭“全局快捷键”、“快速启动”、“热键唤醒”等选项。
三、修改 OpenClaw 热键绑定配置
OpenClaw 支持通过配置文件自定义热键组合，避开系统保留键位（如 Win 键组合）及高频冲突键（如 Ctrl+Shift+C/V）。该操作无需重新编译，仅需编辑 JSON 配置。
1、定位配置文件路径：~/.openclaw/config.json（Linux/macOS）或 %APPDATA%\OpenClaw\config.json（Windows）。
2、用文本编辑器打开该文件，查找 "hotkey" 字段。
完整的工作区安全套件：检测未授权修改，扫描提示注入模式，自动响应应对措施——快照恢复、技能隔离、Git回滚和自动保护扫描。智能体工作区的完整安装后安全层。
3、将原值（如 "ctrl+shift+z"）替换为低冲突组合，例如：
"hotkey": "alt+shift+x"
"hotkey": "ctrl+alt+space"
"hotkey": "win+shift+o"
4、保存文件后，重启 OpenClaw Gateway（使用对应模式命令启动）。
5、验证新热键是否生效：按下组合键，观察终端日志中是否出现 "Hotkey triggered" 日志行。
四、启用内核级热键隔离（Windows 专属）
在 Windows 平台，部分热键被系统或驱动层拦截，普通用户态注册无效。OpenClaw 可借助 OpenArk 内核能力绕过限制，实现更高优先级热键捕获。
1、下载并运行最新版 OpenArk64.exe（需管理员权限）。
2、点击右下角“进入内核模式”，按提示关闭 HVCI（内存完整性）并重启系统。
3、重启后再次启动 OpenArk，进入“Kernel → System Hotkey”页面。
4、在热键列表中查找 openclaw gateway 对应条目，右键选择“提升优先级”。
5、返回 OpenClaw 终端，执行 openclaw gateway restart 使变更生效。
五、重置热键表并强制重载
当热键注册表项损坏或缓存异常时，OpenClaw 可能无法正确注销旧热键。此时需手动清空热键注册表缓存并触发全量重载。
1、停止当前 OpenClaw Gateway 实例（无论何种模式）。
2、执行以下命令清除热键缓存：
openclaw gateway clear-hotkey-cache
3、检查缓存目录是否存在残留：
ls -la ~/.openclaw/cache/hotkey/ 2>/dev/null || echo "cache dir not found"
4、若存在，手动删除整个 hotkey 子目录：
rm -rf ~/.openclaw/cache/hotkey/
5、重新启动 OpenClaw Gateway，并立即在终端中运行：
openclaw gateway reload-hotkey
6、观察输出中是否包含 "Hotkey table reloaded successfully" 提示。
