Skip to main content
macOS 应用是 OpenClaw 的 菜单栏伴侣:原生托盘界面、macOS 权限提示、通知、WebChat、语音输入、Canvas,以及 由 Mac 托管的节点工具,例如 system.run 使用 Quick Chat,即可在不打开完整窗口的情况下,使用 Spotlight 风格的主会话输入框。默认按下 Option-Space(⌥Space),从菜单栏菜单中选择,或在 设置 → 通用 中录制其他快捷键。 完整的原生聊天支持通过选择器、粘贴以及拖放来添加图片附件。助手生成的图片会通过短期有效的 Gateway artifact URL 内联显示,并可在更大的预览中打开;iOS 和 macOS 共享同一套有界图片模型和渲染器。 只需要 CLI 和 Gateway?请从开始使用开始。

下载

OpenClaw GitHub 发布页 获取 macOS 应用构建版本。 当某个发布包含 macOS 应用资源时,请查找:
  • OpenClaw-<version>.dmg(首选)
  • OpenClaw-<version>.zip
有些发布只包含 CLI、证据或 Windows 资源。如果最新发布 没有 macOS 应用资源,请使用最新的包含该资源的版本,或者通过 macOS 开发环境设置 从源代码构建。

首次运行

  1. 安装并启动 OpenClaw.app
  2. 对于本地 Gateway,选择 此 Mac;或者连接到远程 Gateway。
  3. 等待应用安装匹配的 CLI 运行时。在本地模式下,它还会 安装并启动 Gateway。
  4. 通过实时模型检查建立推理连接。如果应用复用了你不想使用的登录信息,请在成功横幅上选择 选择其他 AI,以重新打开选择器,其中包括 API 密钥选项。
  5. 完成。应用会打开仪表板,OpenClaw 将在一次对话中引导完成其余设置 (导入记忆、频道、权限)。你可以随时从 设置 → 权限 授予 macOS 权限。
如果应用连接到一个现有 Gateway,且其默认 agent 已配置 模型,则会将该 Gateway 视为已完成设置,跳过 provider onboarding 和 OpenClaw,并打开仪表板。如果 Gateway 无法连接,或者其 默认 agent 没有模型,则仍可进行推理入门以便恢复。 对于 CLI/Gateway 设置路径,请使用 入门指南。 如需恢复权限,请使用 macOS 权限

更新

仪表盘更新卡片会说明应用将更新的内容:
  • 更新 Mac 应用 + Gateway 表示已签名的应用拥有本地的 launchd Gateway。Sparkle 会先更新应用;重新启动后,应用会自动将其 Gateway 更新并重启到匹配的版本,然后验证连接。
  • 更新 Gateway 表示应用连接的是远程 Gateway、手动管理的本地 Gateway,或应用不拥有的其他安装实例。此按钮会运行该 Gateway 的常规更新流程,而不是更改 Mac 应用。
任一按钮都会先请求确认。只有在你选择更新 Mac 应用并重新启动后,卡片才会将更新交给应用处理,因此误点击不会启动 Sparkle。 协调更新失败后,应用会停留在设置样式的窗口中,并提供重试、更新指南和 Discord 操作。自动修复绝不会将较新的 Gateway 降级,也不会覆盖 extended-stable 通道固定设置。 成功更新后,应用会找到最近一次由人使用的、顶层的直接会话,并向该代理发送一次性的更新事件。心跳和 cron 活动不会影响这一选择。然后,代理可以从你最可能正在使用的对话中欢迎你回来。在远程模式下,应用只会更新本地 Mac 节点运行时,并且当远程 Gateway 版本比应用更旧时会跳过通知。 Sparkle 遵循 Gateway 的 update.channel 设置。betadev 会选择加入 beta 应用构建版本;extended-stable 只接受 extended-stable 应用版本,因此在没有匹配的应用版本时会保持静默。stable、缺失值和 未知值会继续使用 stable 应用构建版本。

打开仪表盘链接

在 macOS 应用内嵌的仪表盘中,点击外部网页链接会在可调整大小的浏览器侧边栏中打开页面,宽度为窗口的一半,同时保留仪表盘导航可见。拖动分隔线即可选择其他宽度;应用会记住该设置。每个链接都会在自己的标签页中打开;当打开多个页面时,标签栏会显示出来;再次点击同一链接时,会复用其现有标签页。拖动标签页即可重新排序;使用标签页关闭按钮或鼠标中键点击即可关闭标签页;右键单击标签页可选择 在默认浏览器中打开复制链接重新加载关闭标签页关闭其他标签页。窗口标题栏中的后退/前进控件以及触控板滑动手势可浏览仪表盘历史记录;侧边栏自身的后退/前进控件则用于浏览当前标签页的历史记录。侧边栏还提供重新加载、在默认浏览器中打开和关闭控件。 标题栏控件会随应用侧边栏变化:当侧边栏展开时,后退/前进按钮位于其右侧边缘,紧挨着侧边栏切换按钮;当侧边栏折叠时,它们则为搜索按钮(打开命令面板)和新会话按钮让出位置。 右键单击外部链接可选择 在侧边栏中打开在默认浏览器中打开复制链接。从仪表盘中进行的带修饰键点击,以及用户主动触发的新窗口链接,仍会在默认浏览器中打开;侧边栏内的新窗口链接会作为新的侧边栏标签页打开。普通浏览器承载的 Control UI 页面会保持浏览器默认的链接和上下文菜单行为。

导入浏览器登录信息

当应用在本地 Gateway 上运行时,浏览器侧边栏首次打开,如果 Mac 上存在带有 cookie 的 Chrome 系列配置文件,仪表板会显示一个可关闭的横幅。该横幅提供将这些 cookie 复制到一个隔离的受管配置文件中的选项,代理会使用该配置文件进行浏览。通过其 导入 控件选择一个配置文件(可能需要 Touch ID);进度和已导入的 cookie 数量会以内联方式显示,并且只会复制 cookie——密码绝不会离开源浏览器。关闭该横幅会记录该选择;随时可通过 设置 → 常规 → 浏览器登录 → 导入… 重新显示。有关底层导入流程和 browser.allowSystemProfileImport 开关,请参阅 Browser

选择 Gateway 模式

两种模式都需要已安装 openclaw CLI,因为应用会复用其 node-host 运行时。在全新的 Mac 上,应用会自动安装匹配的 CLI;本地 模式随后会启动 Gateway 向导,而远程模式会连接到所选的 Gateway,而不会再启动第二个本地 Gateway。 有关手动恢复,请参见 macOS 上的 Gateway

应用程序拥有的内容

  • 菜单栏状态、通知、健康状态、WebChat 以及浮动的 Quick Chat 栏。
  • macOS 针对屏幕、麦克风、语音、自动化和辅助功能的权限提示。
  • 一个 Mac 节点,将原生 Canvas、摄像头/屏幕捕获、通知、位置和电脑控制,与 CLI 节点主机的系统、浏览器、插件、技能和 MCP 命令相结合。
  • Mac 主机命令的执行批准提示。
  • 经批准的 Shell 命令的应用上下文执行,同时保留应用的 macOS 权限归属,并由 CLI 运行时负责共享节点策略。
  • 远程模式下的 SSH 隧道或直接 Gateway 连接。
在嵌入式控制界面中,设置 → 通知显示的是应用的原生通知权限,而不是浏览器推送权限,因为应用会以原生方式发送通知。 应用不会取代 Gateway 或通用 CLI 文档。Gateway 配置、提供商、插件、频道、工具和安全性都有各自的文档。

macOS 详细页面

相关内容