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
首次运行
- 安装并启动 OpenClaw.app。
- 对于本地 Gateway,选择 此 Mac;或者连接到远程 Gateway。
- 等待应用安装匹配的 CLI 运行时。在本地模式下,它还会 安装并启动 Gateway。
- 通过实时模型检查建立推理连接。如果应用复用了你不想使用的登录信息,请在成功横幅上选择 选择其他 AI,以重新打开选择器,其中包括 API 密钥选项。
- 完成。应用会打开仪表板,OpenClaw 将在一次对话中引导完成其余设置 (导入记忆、频道、权限)。你可以随时从 设置 → 权限 授予 macOS 权限。
更新
仪表盘更新卡片会说明应用将更新的内容:- 更新 Mac 应用 + Gateway 表示已签名的应用拥有本地的 launchd Gateway。Sparkle 会先更新应用;重新启动后,应用会自动将其 Gateway 更新并重启到匹配的版本,然后验证连接。
- 更新 Gateway 表示应用连接的是远程 Gateway、手动管理的本地 Gateway,或应用不拥有的其他安装实例。此按钮会运行该 Gateway 的常规更新流程,而不是更改 Mac 应用。
extended-stable 通道固定设置。
成功更新后,应用会找到最近一次由人使用的、顶层的直接会话,并向该代理发送一次性的更新事件。心跳和 cron
活动不会影响这一选择。然后,代理可以从你最可能正在使用的对话中欢迎你回来。在远程模式下,应用只会更新本地 Mac 节点运行时,并且当远程 Gateway 版本比应用更旧时会跳过通知。
Sparkle 遵循 Gateway 的 update.channel 设置。beta 和 dev 会选择加入
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 连接。