OpenClaw 在 macOS 上提供一个原生的菜单栏伴侣 App， 不只是 CLI 工具，还可以访问 macOS 独有的系统能力。
macOS App 是什么？
OpenClaw macOS Companion App 是一个菜单栏常驻应用：
菜单栏图标（🦞 龙虾）
├── 显示 Gateway 运行状态
├── 管理 Gateway 进程（启动/停止/重启）
├── 代理执行系统权限申请（TCC 弹窗）
├── 接收和显示系统通知
└── 暴露 macOS 专属能力给 AI Agent
它能做 CLI 做不到的事：
- 访问麦克风（语音唤醒）
- 截取屏幕内容
- 控制摄像头
- 渲染 Canvas 画布
- 系统级 UI 自动化（Peekaboo Bridge）
安装方式
bash
# 方式 1：通过 Homebrew（推荐）
brew install --cask openclaw
# 方式 2：官网下载 .dmg
# 访问 https://openclaw.ai/download → 下载 macOS App
# 安装后从 Launchpad 或 Applications 启动
# 首次启动会申请必要的系统权限首次设置
首次启动会引导你完成权限申请：
1. 通知权限 → 允许（接收 AI 回复通知）
2. 辅助功能权限 → 允许（系统自动化功能）
3. 屏幕录制权限 → 允许（截图和 Canvas 功能）
4. 麦克风权限 → 允许（语音唤醒功能）
5. 联系 API → 输入 AI 提供商的 API Key
设置完成后，菜单栏出现 🦞 图标表示运行中。
本地模式 vs 远程模式
本地模式（默认）
macOS App
└── 管理本机 Gateway 进程
└── 处理所有 AI 请求
App 自动启动和管理本地 Gateway，最简单的方式。
远程模式
macOS App（节点模式）
└── 连接到远程 VPS 上的 Gateway
└── 本地 Mac 作为「节点」提供本地能力
远程 Gateway 处理 AI 逻辑
本地 Mac 提供：截图、摄像头、Canvas、Bash 执行
适合 Gateway 部署在 VPS 上、想用手机/Telegram 控制、 同时又需要 AI 访问本地文件和能力的场景。
切换到远程模式：
菜单栏图标 → 设置 → Gateway 模式 → 远程
输入远程 Gateway 地址（如 Tailscale IP 或公网 IP）
LaunchAgent 管理
OpenClaw 通过 macOS LaunchAgent 实现开机自启：
bash
# 手动控制（如果需要）
# 启动
launchctl kickstart -k gui/$UID/ai.openclaw.gateway
# 停止
launchctl bootout gui/$UID/ai.openclaw.gateway
# 查看状态
launchctl print gui/$UID/ai.openclaw.gateway
# 通过 CLI 安装/卸载 LaunchAgent
openclaw gateway install # 安装
openclaw gateway uninstall # 卸载macOS 专属 AI 能力
Canvas 画布
AI 可以在 Canvas 中渲染可视化内容（图表、UI 原型、数据展示）：
你：帮我画一个今天的工作时间分配饼图
AI：[在 Canvas 中渲染交互式饼图]
已在 Canvas 中生成图表，可以点击各部分查看详情。
屏幕截图与分析
你：截图看看我现在的代码哪里写错了
AI：[截取当前屏幕]
我看到了你的代码，第 23 行有个问题：...
摄像头
你：用摄像头看看我桌上这本书的标题
AI：[启动摄像头拍照]
我看到这本书的标题是「...」
语音唤醒（Voice Wake）
配置唤醒词后，说出唤醒词即可免手动打字：
配置步骤：
1. 菜单栏 → 设置 → 语音唤醒
2. 启用「语音唤醒」
3. 设置唤醒词（如「嘿小助」或「Hey Claude」）
4. 说出唤醒词，等待提示音，然后说出你的指令
示例：
「嘿小助」→ 提示音 →「帮我总结一下这个 GitHub Issue」
系统自动化（Peekaboo Bridge）
OpenClaw 通过 Peekaboo 集成支持 macOS UI 自动化：
你：帮我打开 Safari，搜索"Claude Code 最新动态"，截图给我
AI：[自动化执行]
1. 打开 Safari
2. 在地址栏输入搜索词
3. 截取搜索结果
[返回截图]
菜单栏图标状态说明
| 图标状态 | 含义 |
|---|---|
| 🦞 正常绿色 | Gateway 运行中，一切正常 |
| 🦞 黄色/橙色 | Gateway 运行但有警告（如未配置某频道） |
| 🦞 灰色 | Gateway 未运行 |
| 🦞 红色 | 错误状态，需要检查 |
点击图标打开菜单：
- Dashboard → 在浏览器打开控制面板
- Chat → 打开本地 WebChat 界面
- Start/Stop Gateway → 控制 Gateway 进程
- Preferences → App 设置
来源：OpenClaw 官方文档 - docs.openclaw.ai/platforms/macos