openclaw提供五类快捷键配置方式:一、web界面全局快捷键(如f11全屏、/聚焦命令栏);二、系统级热键绑定(sxhkd/hammerspoon或powertoys);三、内置hotkeys图形化管理界面;四、config.yaml手动注入;五、webchat软键盘联动websocket。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您正在使用 OpenClaw Web 界面或终端环境,但尚未掌握其高效交互方式,则可能是由于未启用或不熟悉内置快捷键。该方法适用于通过浏览器访问 OpenClaw Dashboard 的用户,所有快捷键均在页面获得焦点时生效,无需额外配置。
一、Web界面全局快捷键配置
该方式直接利用前端 JavaScript 监听器实现系统级响应,所有操作均在浏览器上下文中完成,不依赖外部工具或权限提升,适合日常高频操作场景。
1、按下F11键(Windows/Linux)或⌘+Ctrl+F(macOS),立即切换至系统级全屏模式,隐藏浏览器地址栏与工具栏。
2、在任意输入框外按下/,光标自动聚焦至顶部命令栏,进入内嵌 CLI 模式,支持输入/status、/logs等短指令。
3、按下Ctrl + Shift + R,强制重载当前 UI 视图,跳过浏览器缓存并重新拉取 dist 资源,适用于界面样式错乱或组件未更新场景。
4、按下Ctrl + Shift + L,在控制台底部弹出悬浮式日志面板,实时显示最近 50 行 gateway 日志,不依赖终端窗口。
二、系统级热键绑定实现全局唤起
该方法通过操作系统级热键管理工具将按键事件转化为 CLI 调用,绕过浏览器焦点限制,实现任意应用前台下的即时触发,适用于需脱离 WebUI 独立唤起 OpenClaw 的场景。
1、在 Linux 或 macOS 上安装 sxhkd 或 Hammerspoon:执行 sxhkd -c ~/.config/sxhkd/sxhkdrc 启动热键守护进程。
2、编辑热键配置文件,在其中添加一行:super + shift + c : openclawgateway --trigger=manual。
3、保存后重启 sxhkd 服务,按下 Super+Shift+C 即可向 OpenClaw 网关发送手动触发信号。
4、在 Windows 上使用 PowerToys Keyboard Manager,创建新快捷键规则,将 Ctrl+Alt+K 映射为运行 powershell -Command "openclaw gateway --trigger=manual"。
三、OpenClaw 内置快捷键管理界面配置
该方式提供图形化快捷键管理入口,支持为已安装的 Skill 或自定义命令分配组合键,无需修改代码即可生效,所有配置经由网关统一注入监听器,具备跨平台一致性。
1、启动 OpenClaw 控制面板:在终端执行 openclaw dashboard,等待 WebUI 在浏览器中打开。
2、点击左侧导航栏中的 快捷键(Hotkeys) 选项卡。
3、点击右上角 + 添加快捷键 按钮。
4、在弹出表单中填写:触发组合键(如 Ctrl+Alt+L)、目标 Skill 名称(如 “截图识字” 或 “微信消息转发”)、执行模式(同步/异步)。
5、点击保存,系统将自动注入全局监听器并提示 “快捷键已激活”。
四、通过 config.yaml 手动注入热键映射
该方式适用于需要精确控制触发逻辑、绑定非标准组合键(如 Win+Shift+Q)或批量配置多个快捷键的进阶用户,配置直接写入主配置文件,重启网关后持久生效,不受 WebUI 状态影响。
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 使新配置加载。
五、WebChat UI 软键盘与快捷键联动配置
该方式通过前端 JavaScript 劫持 document.onkeydown 事件,将特定按键序列转为 WebSocket 消息发送至本地网关端口,绕过 CLI 层直接注入会话上下文,适用于 Web 端高频交互及低延迟响应需求。
1、定位 WebChat 静态资源目录:~/.openclaw/webchat/dist/。
2、在 index.html 底部插入自定义 <script></script> 标签,监听 Ctrl+Enter 并发送 WebSocket 消息:{"type":"key_trigger","payload":{"action":"quick_report"}}。











