macOS 应用

macOS 应用是 OpenClaw 的菜单栏配套应用：提供原生托盘 UI、macOS 权限提示、通知、WebChat、语音输入、Canvas，以及 system.run 等由 Mac 托管的节点工具。

只需要 CLI 和 Gateway 网关？请从入门指南开始。

下载

从 OpenClaw GitHub 发布页面获取 macOS 应用构建版本。 如果某个发布版本包含 macOS 应用资源，请查找：

• OpenClaw-<version>.dmg（首选）
• OpenClaw-<version>.zip

某些发布版本仅包含 CLI、证据工件或 Windows 资源。如果最新发布版本 没有 macOS 应用资源，请使用包含该资源的最新版本，或按照 macOS 开发环境设置从源代码构建。

首次运行

1. 安装并启动 OpenClaw.app。
2. 为本地 Gateway 网关选择 This Mac，或连接到远程 Gateway 网关。
3. 等待应用安装匹配的 CLI 运行时。在本地模式下，它还会 安装并启动 Gateway 网关。
4. 通过实时模型检查建立推理连接。检查通过后，由 Crestodian 完成其余设置。
5. 完成 macOS 权限检查清单，并发送新手引导测试消息。

如果应用连接到的现有 Gateway 网关，其默认智能体已配置 模型，它会将该 Gateway 网关视为已设置，跳过提供商新手引导和 Crestodian，并打开仪表盘。如果无法连接 Gateway 网关，或其 默认智能体没有模型，则仍可使用推理新手引导进行 恢复。

对于 CLI/Gateway 网关设置路径，请使用入门指南。 对于权限恢复，请使用 macOS 权限。

更新

仪表盘更新卡片会先通过 Sparkle 更新已签名的 macOS 应用。 应用重新启动后，它会自动更新并重启匹配的、 由应用管理的本地 Gateway 网关。Homebrew 和其他由用户管理的 CLI 安装仍使用 常规 Gateway 网关更新流程（卡片会直接运行 Gateway 网关更新）， 并且自动修复绝不会降级较新的 Gateway 网关，也不会覆盖 extended-stable 渠道固定设置。

Sparkle 遵循 Gateway 网关的 update.channel 设置。beta 和 dev 会选择使用 Beta 应用构建版本；stable、extended-stable 以及缺失或未知的值 仍使用稳定版应用构建。

打开仪表盘链接

在 macOS 应用的嵌入式仪表盘中，点击外部网页链接会在可调整大小的浏览器侧边栏中打开该链接。每个链接会在独立标签页中打开；再次点击同一链接会复用现有标签页。拖动标签页可重新排序，使用标签页关闭按钮或中键点击可将其关闭，右键点击标签页可使用 Open in Default Browser、Copy Link、Reload、Close Tab 和 Close Other Tabs。窗口标题栏的后退/前进控件和触控板轻扫用于浏览仪表盘历史记录；侧边栏自身的后退/前进控件用于浏览当前标签页的历史记录。侧边栏还提供重新加载、在默认浏览器中打开和关闭控件，并会记住其宽度。

标题栏控件会随应用侧边栏变化：展开侧边栏时，后退/前进控件位于其右侧边缘、侧边栏切换按钮旁；折叠侧边栏时，它们会让位于搜索按钮（用于打开命令面板）和新建会话按钮。

右键点击外部链接可选择 Open in Sidebar、Open in Default Browser 或 Copy Link。从仪表盘发起的组合键点击和用户激活的新窗口链接仍会在默认浏览器中打开；侧边栏中的新窗口链接则会作为新的侧边栏标签页打开。在常规浏览器中托管的 Control UI 页面仍保持浏览器正常的链接和上下文菜单行为。

导入浏览器登录信息

当应用连接本地 Gateway 网关运行，且 Mac 上存在带 Cookie 的 Chrome 系浏览器配置文件时，仪表盘窗口会显示一个可关闭的横幅，提示将这些 Cookie 复制到智能体浏览网页时使用的隔离托管配置文件中。从横幅的 Import 控件中选择配置文件（可能需要 Touch ID）；进度和已导入的 Cookie 数量会以内联方式显示，并且只会复制 Cookie——密码绝不会离开源浏览器。关闭横幅会记录此选择；通过 Settings → General → Browser login → Import… 可随时再次显示该提示。有关底层导入流程和 browser.allowSystemProfileImport 门控，请参阅浏览器。

选择 Gateway 网关模式

两种模式都需要安装 openclaw CLI，因为应用会复用其节点主机 运行时。在全新的 Mac 上，应用会自动安装匹配的 CLI；随后，本地 模式会启动 Gateway 网关向导，而远程模式会连接到选定的 Gateway 网关，不会启动第二个本地 Gateway 网关。 有关手动恢复，请参阅 macOS 上的 Gateway 网关。

应用负责的内容

• 菜单栏状态、通知、健康状态和 WebChat。
• 针对屏幕、麦克风、语音、自动化和辅助功能的 macOS 权限提示。
• 一个 Mac 节点，将原生 Canvas、摄像头/屏幕捕获、通知、 位置和计算机控制功能，与 CLI 节点主机的系统、浏览器、 插件、技能和 MCP 命令相结合。
• Mac 托管命令的 Exec 审批提示。
• 在应用上下文中执行已批准的 Shell 命令，在 CLI 运行时负责共享节点策略的同时，保留应用的 macOS 权限归属。
• 远程模式的 SSH 隧道或直接 Gateway 网关连接。

应用不会取代 Gateway 网关或通用 CLI 文档。Gateway 网关 配置、提供商、插件、渠道、工具和安全性均在各自的 文档中说明。

macOS 详情页面

相关内容

• 平台
• 入门指南
• Gateway 网关
• Exec 审批