system.run。
使用快速聊天可在不打开完整窗口的情况下,通过类似 Spotlight 的主会话输入框编写消息。默认按 Option-Space(⌥Space),也可以从菜单栏菜单中选择,或在 Settings → General 中录制其他快捷键。
只需要 CLI 和 Gateway 网关?请从入门指南开始。
下载
从 OpenClaw GitHub 发布页面获取 macOS 应用构建版本。 当某个发布版本包含 macOS 应用资产时,请查找:OpenClaw-<version>.dmg(首选)OpenClaw-<version>.zip
首次运行
- 安装并启动 OpenClaw.app。
- 选择 This Mac 以使用本地 Gateway 网关,或连接到远程 Gateway 网关。
- 等待应用安装匹配的 CLI 运行时。在本地模式下,它还会 安装并启动 Gateway 网关。
- 通过实时模型检查建立推理连接。检查通过后,OpenClaw 会处理其余设置。
- 完成 macOS 权限检查清单并发送新手引导测试消息。
更新
仪表板更新卡片会注明应用将更新的内容:- 更新 Mac 应用 + Gateway 网关表示已签名应用拥有本地 launchd Gateway 网关。Sparkle 会先更新应用;应用重新启动后,会自动 将其 Gateway 网关更新至匹配版本并重启,然后验证 连接。
- 更新 Gateway 网关表示应用已连接到远程 Gateway 网关、手动 管理的本地 Gateway 网关,或应用不拥有的其他安装。该按钮 会运行相应 Gateway 网关的常规更新流程,而不会更改 Mac 应用。
extended-stable 渠道固定版本。
成功更新后,应用会查找最近由用户使用的
顶层直接会话,并向该智能体发送一次性更新事件。Heartbeat
和定时任务活动不会影响此选择。然后,该智能体可以从
你最可能正在使用的对话中欢迎你回来。在远程模式下,应用
仅更新本地 Mac 节点运行时;当远程 Gateway 网关版本早于应用时,
会跳过通知。
Sparkle 遵循 Gateway 网关的 update.channel 设置。beta 和 dev 会选择加入
测试版应用构建;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 节点主机的系统、浏览器、 插件、Skills 和 MCP 命令相结合。
- Mac 托管命令的 Exec 审批提示。
- 在应用上下文中执行已批准的 shell 命令,在由 CLI 运行时负责共享节点策略的同时,保留应用的 macOS 权限归属。
- 远程模式 SSH 隧道或直接 Gateway 网关连接。