它是什么
OpenClaw macOS 应用以菜单栏图标的形式常驻系统，是 macOS 平台的核心管理入口。它负责申请系统权限、管理本地或远程 Gateway 的生命周期，并向 AI 智能体暴露 macOS 原生能力——包括屏幕录制、摄像头、通知推送、Canvas 画布以及终端命令执行。
安装与初始化
- 下载并启动
OpenClaw.app - 完成权限授权清单（系统会逐项弹出 TCC 授权弹窗）：
- 通知、辅助功能、屏幕录制、麦克风、语音识别、AppleScript
- 在菜单栏确认 Gateway 状态为「本地模式」已就绪
- 可选：通过 npm/pnpm 安装全局 CLI 工具
npm install -g openclaw
# 或
pnpm add -g openclaw
本地模式与远程模式
本地模式（默认）： 应用自动连接本地运行的 Gateway，或通过 openclaw gateway install 注册 launchd 服务让 Gateway 开机自启。
远程模式： 应用通过 SSH 隧道或 Tailscale 连接远端服务器上的 Gateway，本机不启动 Gateway 进程，只运行节点服务。这适合将计算密集型任务放在服务器上，而 macOS 仅作为感知节点使用。
LaunchAgent 管理
macOS 应用会注册一个每用户级别的 LaunchAgent，标签为 ai.openclaw.gateway。常用控制命令：
# 重启 Gateway 服务
launchctl kickstart -k gui/$UID/ai.openclaw.gateway
# 停止 Gateway 服务
launchctl bootout gui/$UID/ai.openclaw.gateway
注意： 状态目录（
OPENCLAW_STATE_DIR）应避免放在 iCloud 或任何云同步文件夹中，推荐使用~/.openclaw，以防文件锁冲突和同步竞争问题。
命令执行安全策略
AI 智能体通过 system.run 工具执行终端命令，其权限由本地配置文件 ~/.openclaw/exec-approvals.json 管理：
{
"version": 1,
"defaults": { "security": "deny", "ask": "on-miss" },
"agents": {
"main": {
"security": "allowlist",
"ask": "on-miss",
"allowlist": [{ "pattern": "/opt/homebrew/bin/rg" }]
}
}
}
包含 &&、||、|、;、反引号、$、重定向等 Shell 特殊语法的命令，都需要显式授权才能执行。环境变量也会被过滤，仅保留 TERM、LANG、LC_* 等基本变量。
深链接触发
macOS 应用注册了 openclaw:// URL Scheme，可从浏览器、快捷指令或任何脚本中直接唤起 AI 执行任务：
open 'openclaw://agent?message=Hello%20from%20deep%20link'
可选参数包括 sessionKey、thinking、deliver、timeoutSeconds、key（用于无人值守自动化）。
节点能力一览
macOS 应用向 Gateway 注册的节点命令集：
- Canvas：展示、导航、脚本执行、截图、UI 自动化
- Camera：拍照、录制视频片段
- Screen：屏幕录制
- System：执行命令、发送通知
这些能力让 AI 智能体可以真正「看到」和「操控」你的 Mac，是 OpenClaw 多模态交互的基础。