——
OpenClaw macOS 新功能：3 步配置 Dock 菜单快捷操作
一句话总结：OpenClaw 最新版本为 macOS 用户新增了 Dock 菜单快捷操作功能，让你无需打开主界面即可快速触发 AI Agent 任务，工作效率提升 50% 以上。
如果你是一名 macOS 重度用户，一定熟悉通过 Dock 图标右键菜单快速执行操作的体验。现在，OpenClaw 这一开源 AI Agent 框架也正式支持了这一原生 macOS 交互模式，让 AI 助手的调用更加无缝自然。
—
什么是 Dock 菜单快捷操作？
Dock 菜单快捷操作（Dock Menu Shortcuts）是 macOS 系统提供的标准功能，允许应用程序在 Dock 图标右键菜单中注册自定义操作项。用户无需打开应用主窗口，直接通过 Dock 即可执行特定任务。
对于 OpenClaw 这类 AI Agent 工具而言，这意味着：
| 传统流程 | Dock 快捷流程 |
|———|————|
| 点击图标 → 等待主窗口加载 → 选择功能 → 执行任务 | 右键 Dock 图标 → 直接选择任务 → 即时执行 |
—
本次更新详解
根据 GitHub 提交记录，本次 feat(macos): add Dock menu shortcuts 更新为 OpenClaw 引入了完整的 Dock 菜单支持。
核心改进点
1. 原生 macOS 集成 — 使用 NSApplication 的 dockMenu API 实现
2. 动态菜单项 — 支持根据当前 Agent 状态动态显示可用操作
3. 后台任务支持 — 即使主窗口关闭，Dock 菜单仍可响应
—
如何启用与配置
前提条件
- OpenClaw 版本 ≥ 0.8.0
- macOS 版本 ≥ 12.0 (Monterey)
- 已安装 OpenClaw CLI 或 OpenClaw Desktop
步骤一：更新到最新版本
通过 Homebrew 更新
brew upgrade openclaw
或通过源码安装最新版
git clone https://github.com/openclaw/openclaw.git
cd openclaw
git checkout bd69510 # 本次更新的 commit
cargo build --release --features macos-dock
步骤二：配置 Dock 菜单项
编辑你的 Agent 配置文件 ~/.openclaw/agents/default/config.toml：
[macos.dock]
enabled = true
[[macos.dock.items]]
id = "quick-chat"
title = "快速对话"
icon = "message.fill"
action = "trigger_agent"
params = { mode = "chat", context = "general" }
[[macos.dock.items]]
id = "code-review"
title = "审查当前文件"
icon = "doc.text.magnifyingglass"
action = "trigger_agent"
params = { mode = "code_review", auto_detect_file = true }
[[macos.dock.items]]
id = "sync-notes"
title = "同步笔记到知识库"
icon = "arrow.triangle.2.circlepath"
action = "trigger_workflow"
params = { workflow = "note_sync" }
步骤三：重启应用生效
完全退出后重新启动
killall OpenClaw
openclaw --daemon &
配置完成后，右键点击 Dock 中的 OpenClaw 图标，即可看到自定义菜单项：
![Dock 菜单示意图 – 包含”快速对话”、”审查当前文件”、”同步笔记”三个选项]
—
实际应用场景
场景一：开发者的代码助手
作为程序员，你可以配置 Dock 菜单实现：
- 一键代码审查：右键 → “审查当前文件” → AI 自动分析 VS Code 当前打开的文件
- 快速生成提交信息：右键 → “生成 Commit Message” → 读取 git diff 并输出规范提交信息
[[macos.dock.items]]
id = "gen-commit"
title = "生成 Commit Message"
action = "shell_command"
command = "git diff --cached | openclaw agent run -p '生成符合 Conventional Commits 规范的提交信息'"
场景二：知识工作者的信息管家
- 即时剪藏：右键 → “保存到 Readwise” → 自动提取剪贴板内容并归档
- 日程速记：右键 → “创建 5 分钟后提醒” → 语音输入转文本并设置提醒
场景三：多 Agent 快速切换
如果你有多个专用 Agent（编程、写作、翻译），可在 Dock 菜单中直接选择：
[[macos.dock.items]]
title = "切换到编程助手"
action = "switch_agent"
agent_id = "code-assistant"
[[macos.dock.items]]
title = "切换到写作助手"
action = "switch_agent"
agent_id = "writing-coach"
—
高级配置技巧
动态隐藏/显示菜单项
根据系统状态条件显示菜单项：
[[macos.dock.items]]
id = "resume-workflow"
title = "继续中断的工作流"
action = "resume_last_workflow"
仅当有中断的工作流时显示
condition = "has_interrupted_workflow"
快捷键绑定
配合 macOS 系统快捷键实现纯键盘操作：
在系统设置 → 键盘 → 快捷键 → 服务中
为 OpenClaw Dock 菜单项分配 ⌃⌥⌘O 等组合键
—
FAQ
Q1: Dock 菜单和全局快捷键有什么区别？哪个更好用？
A: 两者互补。全局快捷键适合完全无感知的快速触发（如截图后自动 OCR），Dock 菜单则适合需要视觉确认、或选项较多的场景。建议高频简单操作用快捷键，复杂/条件操作用 Dock 菜单。
Q2: 为什么我的 Dock 菜单没有显示自定义项？
A: 请检查三点：① 确认 OpenClaw 版本 ≥ 0.8.0（运行 openclaw --version）；② 确认配置文件中 [macos.dock] 的 enabled = true；③ 完全退出后重新启动应用（仅关闭窗口不会重启 Dock 进程）。
Q3: 可以添加多少个自定义菜单项？
A: macOS 建议最多 5-6 个顶层菜单项以保证可用性。OpenClaw 支持最多 10 个，超出部分会自动归入”更多”子菜单。推荐按使用频率排序配置。
Q4: Dock 菜单操作会打开主窗口吗？
A: 取决于 action 类型。trigger_agent、shell_command 等后台操作默认不打开窗口；需要用户交互的操作（如 show_chat）则会激活窗口。可通过添加 background = true 强制后台执行。
Q5: Windows 或 Linux 有类似功能吗？
A: 目前该功能为 macOS 独占。Windows 版本计划通过任务栏右键菜单实现类似体验（预计 v0.9.0），Linux 版本将探索 AppIndicator 菜单支持。可关注 OpenClaw 路线图 获取更新。
—
总结与下一步
OpenClaw 的 Dock 菜单快捷操作功能，将 AI Agent 的调用深度整合到 macOS 原生交互中，是提升工作流效率的重要更新。
关键要点回顾：
- ✅ 无需打开主界面即可执行 Agent 任务
- ✅ 支持完全自定义菜单项与动态条件
- ✅ 配置简单，三步骤即可启用
建议下一步行动：
1. 立即更新到 OpenClaw 0.8.0+ 体验新功能
2. 根据你的工作场景设计 3-5 个核心 Dock 菜单项
3. 在 OpenClaw 社区论坛 分享你的配置方案
—
相关阅读
—
参考来源
