13.2 macOS应用

macOS 配套应用是一个菜单栏界面，负责"管理权限、管理/连接本地 Gateway（launchd 或手动），并将 macOS 功能作为节点暴露给 Agent"。

核心功能

• 原生通知和菜单栏状态显示
• 管理系统权限（TCC 提示，包括通知、辅助功能、屏幕录制、麦克风、语音识别和自动化）
• 支持本地或远程 Gateway 模式
• 提供 macOS 特定工具，包括 Canvas、摄像头、屏幕录制和系统命令执行
• 可选的 PeekabooBridge 支持 UI 自动化
• 通过 npm/pnpm 全局安装 CLI

运行模式

本地模式（默认）

连接到现有的本地 Gateway，或通过安装命令启用 launchd 服务。

远程模式

通过 SSH/Tailscale 连接到远程 Gateway，同时启动本地节点主机服务以实现双向通信。

安装 CLI

# 使用 npm 全局安装
npm install -g openclaw

# 或使用 pnpm
pnpm add -g openclaw

# 安装 Gateway 守护进程
openclaw onboard --install-daemon

安全功能

执行审批

通过允许列表系统控制系统命令的执行。设置存储在本地：

~/.openclaw/exec-approvals.json

深度链接集成

通过 openclaw:// URL 方案实现深度链接，支持可选的确认提示。

环境变量过滤

在命令执行期间进行安全过滤，保护敏感信息。

权限管理

应用会请求以下 TCC 权限：

• 通知 - 显示系统通知
• 辅助功能 - UI 自动化支持
• 屏幕录制 - 截屏功能
• 麦克风 - 语音输入
• 语音识别 - 语音转文字
• 自动化 - 控制其他应用

开发与调试

文档包含 Swift 构建说明、打包脚本，以及用于测试 Gateway 连接的 CLI 调试工具（无需启动完整的应用界面）。