macOS 应用

macOS 应用是 OpenClaw 的菜单栏伴侣：原生托盘界面、macOS 权限提示、通知、WebChat、语音输入、托管组件面板，以及 Mac 托管的节点工具（如 system.run）。

使用 Quick Chat 获得 Spotlight 风格的主会话编辑器，而无需打开完整窗口。默认按 Option-Space（⌥Space），从菜单栏菜单中选择，或在仪表盘 → 设置 → 这台 Mac → 应用中录制其他快捷键。

使用绿色窗口按钮进入原生全屏。仪表盘的侧边栏和聊天控件仍保留在窗口顶部。退出全屏后恢复正常的标题栏和窗口控件。

仪表盘加载时，其空白画布跟随原生窗口的外观。页面绘制完成后，仪表盘所选主题提供其背景。

完整的原生聊天支持通过选择器、粘贴和拖放接受图片附件。助手生成的图片通过短时 Gateway 工件 URL 内联渲染，并可打开更大的预览；iOS 和 macOS 共享相同的受限图片模型和渲染器。

只需要 CLI 和 Gateway？从入门开始。

要求¶

OpenClaw.app 需要 macOS 15.0（Sequoia）或更高版本。 这也适用于其原生 openclaw-mac 辅助程序。语音唤醒和按住说话需要 macOS 26 或更高版本。

基于 Node 的 CLI 和 Gateway 需要该运行时支持的操作系统上的受支持的 Node 版本。官方 Node 24 和 Node 26 macOS 二进制文件需要 macOS 13.5 或更高版本。在较旧的 Mac 上运行 CLI 并不会使原生应用与该 macOS 版本兼容。

从源码构建还需要 macOS 开发者设置 中列出的工具链。

下载¶

从 OpenClaw GitHub releases 获取 macOS 应用构建。当某个版本附带 macOS 应用资产时，请查找：

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

某些版本仅附带 CLI、evidence 或 Windows 资产。如果最新版本没有 macOS 应用资产，请使用带有该资产的最新版本，或通过 macOS 开发者设置 从源码构建。

首次运行¶

1. 安装并启动 OpenClaw.app。
2. 选择这台 Mac以使用本地 Gateway，或选择连接到现有 Gateway输入其地址并登录。已保存的 Gateway 在连接后会打开其仪表盘，并完成首次运行设置，而无需更改 Mac 的主 Gateway。设置新 Gateway 时请继续以下步骤。
3. 对于新的本地 Gateway，请等待应用安装其外部 CLI 运行时并启动 Gateway。连接到远程或独立管理的本地 Gateway 不需要在此 Mac 上安装 CLI。
4. 选择你想要的 AI 连接。检测仅显示可用的连接；选择其中一个会启动其实时模型检查。现有已配置的路由显示为当前模型。
5. 完成。应用会打开仪表盘，OpenClaw 在同一个对话中引导其余设置（记忆导入、频道、权限）。可随时从仪表盘 → 设置 → 这台 Mac → 权限授予 macOS 权限。

在引导过程中，现有 Gateway 的已配置模型也会等待你选择后再进行实时检查。检查成功后会打开正常仪表盘并保留已配置的路由。如果 Gateway 无法连接或其默认代理没有模型，推理引导仍可用于恢复。引导后的正常应用启动会继续使用已保存的 Gateway。

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

要添加另一个 Gateway 以访问仪表盘和聊天，请打开连接… → Gateways → 添加 Gateway并输入其主机名或 HTTPS 地址。Cloudflare Access Gateways 允许你在默认浏览器中使用个人账户登录。你也可以从 Gateway 网站上的获取应用 → 在 Mac 应用中打开开始。参见浏览器登录。

从菜单栏选择设置…或按 Cmd-, 打开仪表盘设置。这台 Mac包含应用偏好设置、本地功能、浏览器登录导入、cookie 同步和权限。设备语音控件出现在设置 → 语音 → 这台 Mac下，应用更新偏好设置出现在设置 → 更新 → 这台 Mac下。这些设备控件仅出现在 macOS 应用内嵌的仪表盘中，不会出现在普通浏览器中。

这台 Mac → 功能 → 桌面共享默认启用。它会在系统中暴露这台 Mac 现有的屏幕共享服务，独立于电脑控制和保持电脑唤醒。请在系统设置 → 通用 → 共享中启用屏幕共享，并在请求时批准节点的桌面功能。更新后，现有的显式禁用设置保持关闭；更改 Mac 设置会自动重新连接节点。参见配对节点桌面。

启用敏感功能会打开一个以取消为默认选项的原生确认提示。关闭或替换仪表盘页面会取消待处理的同意；请从当前页面重新请求更改。

连接¶

选择连接…即可打开小型原生窗口，即使 Gateway 无法访问。其连接选项卡包含本地 Gateway 状态、远程/SSH 选项、Tailscale 和发现；Gateways管理已保存的 Gateway 配置文件。当这台 Mac → 开发者中的开发者开关启用时，会出现调试选项卡。同一开关还会在仪表盘和组件面板的上下文菜单中启用检查元素；更改会立即应用于已打开的窗口，无需重启。关于 OpenClaw会选择此窗口中的关于选项卡，其中包含应用版本、构建信息和资源链接。复制构建信息会复制完整的版本、提交和构建时间戳。关于功能可离线使用。

如果应用管理的本地 Gateway 缺失、过时或损坏，“连接”标签页会提供安装 Gateway、更新 Gateway 或修复 Gateway 选项。该操作会打开现有的设置提示，显示安装进度，并在之后检查 Gateway。如果之前取消了某个提示，你可以在这里重试。对于比应用更新且不兼容的 Gateway，设置 Gateway 可让你重新查看设置选择。独立管理的 Gateway 保留其自己的更新工作流。

应用本地设置（权限、Quick Chat、语音、更新）位于“仪表板 → 设置 → 此 Mac”中，并且需要包含这些页面的 Gateway 版本。“连接”标签页中的打开仪表板设置按钮会打开该仪表板。

更新¶

打开仪表板 → 设置 → 更新 → 此 Mac可开启或关闭应用自动更新，选择检查更新…，并查看已安装应用的版本和构建号。该页面会说明更新不可用的情形，包括当某个命名应用配置文件处于活动状态时。

如果主要 Gateway 连接拒绝了应用的协议版本，应用会显示更新提醒，并在其连接状态中保留说明。远程设置和连接探测会以行内形式显示相同的指导。该消息会指明应用版本和双方协议版本，并告知你需要更新哪一侧：在较旧的 Gateway 主机上运行 openclaw update，或从下载选项安装更新的 Mac 应用。被拒绝的握手可能不会报告 Gateway 的发布版本；应用会将该信息标记为不可用。仅是不同的发布版本号不会触发此提醒。

仪表板更新卡片会说明应用将更新什么：

• 更新 Mac 应用 + Gateway 表示签名应用拥有本地 launchd Gateway。Sparkle 会先更新应用；重新启动后，应用会自动将 Gateway 更新并重启到匹配版本，然后验证连接。
• 更新 Gateway 表示应用连接的是远程 Gateway、手动管理的本地 Gateway，或应用不拥有的其他安装。该按钮会运行该 Gateway 的正常更新流程，而不是更改 Mac 应用。

两个按钮都会先要求确认。只有当您选择更新 Mac 应用并重新启动后，卡片才会将更新交给应用处理，因此误点绝不会启动 Sparkle。

失败的协调更新会保留在其设置式窗口中，并提供重试、更新指南和 Discord 操作。自动修复绝不会降级较新的 Gateway，也不会覆盖 extended-stable 渠道的固定版本。

更新成功后，应用会查找最近由人类使用的最顶层直接会话，并向该 agent 发送一次性更新事件。心跳和 cron 活动不影响此选择。之后，该 agent 可以从你很可能正在使用的对话中欢迎你回来。在远程模式下，单独安装、由应用管理的 node 服务保留其自己的运行时更新和恢复流程；当远程 Gateway 比应用旧时，应用会跳过通知。应用的私有 node worker 随应用包本身一起更新。

Sparkle 遵循 Gateway 的 update.channel 设置。beta 和 dev 会选择加入 beta 应用构建；extended-stable 仅接受 extended-stable 应用发布版本，因此当没有匹配的应用发布版本时它会保持安静。stable、缺失值以及未知值会继续使用 stable 应用构建。

打开仪表板链接¶

对于通过浏览器登录添加的已保存 Gateway，仪表板会使用该配置文件的基于 Keychain 的个人会话。你无需在嵌入式浏览器内进行第二次登录。连接… → Gateways 中的重新连接可续期已过期的会话。

对于启用身份感知认证的远程 Gateway，应用会在其登录地址打开仪表板：对于受信任代理认证，使用 HTTPS gateway.publicOrigin；当启用 Tailscale 身份时，使用活动的受管 Tailscale Serve 地址。Serve 不要求 gateway.publicOrigin。如果该配置文件没有已保存的浏览器会话，请在仪表板窗口内完成登录；之后，你现有的 Gateway 配置文件将拥有所显示的身份和聊天归属。原生设备连接会保留其配置的传输方式（包括 SSH），其凭据不会发送到公共仪表板或登录提供方。没有个人登录路由的共享密钥 Gateway 会继续使用共享的所有者配置文件。

已保存 Gateway 配置文件的已打开窗口会在重新连接后跟随登录路由的变化。如果路由未变化，则保持当前仪表板及其导航不变。

仪表板左下角的账户卡片会显示你的姓名、当前 Gateway 及其主要状态。姓名下方的一行副标题会说明计划中的暂停和重启、重新连接以及恢复。发件箱计数涵盖此 Gateway 未解决的消息，包括需要审核的消息；它并不保证每条消息都会自动发送。打开卡片的 Gateway 部分可切换 Gateway，按住 Command-单击或 Control-单击某个 Gateway 可在另一个窗口中打开它，或选择 Gateway 设置…。当当前 Gateway 可以被提升时，会显示 设为主要…。即使只保存了一个 Gateway，这些控件也可用。

在嵌入式仪表板默认的 Chat 落地页打开时，会针对该 Gateway 来源恢复你上次访问的页面（例如 Usage）。显式的会话链接和导航请求优先于记忆的页面，首次运行的模型设置仍会在需要时执行。

在 macOS 应用的嵌入式仪表板中，点击外部网页链接会将其作为 Mac 标签页打开在聊天侧面板的 Browser 标签页中。在非聊天路由上，它会在 shell 级 Browser 停靠区中打开。当设置打开时，外部链接会在默认浏览器中打开，因为 Browser 面板是隐藏的。WebKit 会原生渲染 Mac 标签页，以及与 Gateway 控制浏览器支持的 Agent 浏览器标签页并列显示。较旧的 Control UI 包如果仍发送旧版 inline 链接请求，会打开默认浏览器；当前包则通过原生 Browser 桥接打开 Mac 标签页。

使用标签栏选择或关闭页面，使用地址栏导航，并使用后退、前进、重新加载、停止和在默认浏览器中打开控件来管理当前 Mac 标签页。再次打开同一链接会复用其现有标签页，包括初始重定向后保留的原始 URL。Mac 标签页属于每个窗口，并在聊天会话切换后仍然保留。注释和检查会捕获 Mac 标签页的一次性快照，用于与智能体共享页面上下文。将该标签页导航到不同 URL 会丢弃捕获内容并恢复其实时视图。窗口标题栏的后退/前进控件和触控板轻扫可导航仪表盘历史记录；浏览器面板的控件则导航当前页面。

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

拖动侧面板标签页旁边的空白区域即可移动窗口。标题栏的整个高度都可拖动，可拖动区域会随着标签页的添加、移除或调整大小而变化。标签页和标题栏按钮保持正常的点击和标签页重新排序行为。

当菜单或悬停卡片在仪表盘的其他位置打开时，Mac 标签页保持可见。只有当菜单与标签页的浏览器窗格重叠，或模态对话框或命令面板打开时，标签页的页面才会暂时隐藏，并在遮挡解除后恢复显示。

在停靠的 OpenClaw 聊天面板中，拖动空白标题栏区域或标题即可移动应用窗口。其停靠位置按钮和关闭按钮保持可点击。

在仪表盘中右键单击外部链接，可选择在浏览器面板中打开、在默认浏览器中打开或复制链接。带修饰键的点击仍会在默认浏览器中打开链接。Mac 标签页内的新窗口链接会打开另一个 Mac 标签页；由指针激活的下载会转交给默认浏览器。WebKit 无法显示的响应仅在指针激活的主框架导航时转交默认浏览器；其他无法显示的响应会被静默取消。常规浏览器中托管的 Control UI 页面保持正常的链接和上下文菜单行为，除非你启用了浏览器面板链接偏好设置。

导入浏览器登录信息¶

当应用连接到本地 Gateway 运行时，首次打开 Mac 标签页时，如果 Mac 上存在含 cookie 的 Chrome 系浏览器配置文件，仪表盘会显示一个可关闭的横幅。该横幅可让你将这些 cookie 复制到智能体用于浏览的隔离托管配置文件中。从其导入控件中选择一个配置文件（可能需要 Touch ID）；进度和已导入的 cookie 数量会内联显示，并且只复制 cookie——密码绝不会离开源浏览器。关闭横幅会记录该选择；在本地 Gateway 和符合条件的配置文件可用时，仪表盘 → 设置 → 这台 Mac → 浏览器可重新打开原生导入流程。有关底层导入流程和 browser.allowSystemProfileImport 开关，请参阅浏览器。

切换到非本地模式会隐藏导入横幅，并丢弃待处理状态或横幅结果。已发送到本地 Gateway 的导入可能仍会在那里完成；切换模式不会撤销已复制的 cookie。返回本地模式后，你可以通过设置 → 这台 Mac → 浏览器获取新的导入选项。

将 Cookie 同步到远程计算机¶

导入操作会将 cookie 一次性复制到同一台 Mac 上的配置文件中。当你的 Gateway 和智能体浏览器运行在另一台计算机（专用主机、无头 Linux 主机或云容器）上时，请开启 cookie 同步，以便这台 Mac 让远程浏览器保持登录你选择的站点。

打开仪表盘 → 设置 → 这台 Mac → 浏览器。Cookie 同步默认关闭，仅在本机装有外部 CLI 的远程模式下可用。开启 cookie 同步，将需要保持同步的站点添加到域名允许列表（例如 github.com 和 accounts.google.com），并设置接收这些 cookie 的目标配置文件（远程 Gateway 上的托管配置文件名称，默认为 imported）。状态行会显示同步是否正在运行。

如果待添加的域会恢复已在另一个仪表盘窗口中移除的域，则该添加会被丢弃。请检查更新后的列表，并重新添加所需域。

启用后，应用会监控针对所连接 Gateway 的 openclaw browser cookie-sync --watch 命令。Cookie 会在这台 Mac 上本地解密（每个会话出现一次 macOS 钥匙串或 Touch ID 提示），并通过应用现有的加密 Gateway 连接推送到远程配置文件；只会发送允许列表中的域，cookie 值绝不会写入日志。空允许列表不会同步任何内容。与导入一样，某些 Google 会话使用与设备绑定的会话凭证（DBSC），这些凭证仍与这台 Mac 绑定，同步后可能仍需要重新认证；对于这些站点，请改为通过浏览器节点代理在这台 Mac 本身上驱动浏览器。

选择 Gateway 模式¶

应用的 Mac 节点在两种模式下都使用其自带的私有运行时。只有设置和管理应用自有的本地 Gateway 才需要单独安装 CLI。远程模式以及接入独立管理的本地 Gateway 则无需该安装。可选的 cookie 同步仍要求本机装有外部 CLI，而现有的独立节点服务会维护自己的 CLI 生命周期。手动恢复请参阅 macOS 上的 Gateway。

应用拥有的内容¶

原生代码负责设备本地能力和 Connection 窗口；Dashboard 负责所有设置界面。设备偏好设置保留在这台 Mac 上，而嵌入式 Dashboard 会请求应用读取或更改这些设置，并打开原生权限、快捷方式、麦克风测试或浏览器导入面板。

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

在嵌入式 Control UI 中，Dashboard → Settings → Notifications 显示应用的原生通知权限，而不是浏览器推送，因为应用以原生方式发送通知。

该应用不会替代 Gateway 或通用 CLI 文档。Gateway 配置、提供商、插件、频道、工具和安全相关内容位于各自的文档中。

macOS 详情页¶

相关¶

• 平台
• 入门
• 引导 - macOS 应用的首次运行流程：Gateway 运行位置、运行时安装以及连接提供商
• Gateway
• Exec 审批