macOS 系统支持情况
| macOS 版本 | 版本号 | 支持状态 |
|---|---|---|
| macOS Sequoia | 15.x | ✅ 完整支持（推荐） |
| macOS Sonoma | 14.x | ✅ 完整支持 |
| macOS Ventura | 13.x | ✅ 完整支持 |
| macOS Monterey | 12.x | ✅ 完整支持 |
| macOS Big Sur | 11.x | ⚠️ 有限支持 |
| macOS Catalina 及更早 | 10.15- | ❌ 不支持 |
芯片支持：
- Apple Silicon (M1/M2/M3/M4)：原生 ARM 版本，性能最优
- Intel Mac：x64 版本，正常运行
- Rosetta 转译：不推荐，请下载对应架构的原生版本
确认 Mac 处理器类型
通过界面确认
点击左上角苹果图标 → 关于本机，查看"芯片"或"处理器"字段：
- Apple M1 / M2 / M3 / M4 → 下载 Apple Silicon (ARM64) 版本
- Intel Core → 下载 Intel (x64) 版本
通过终端确认
uname -m
输出 arm64 → Apple Silicon；输出 x86_64 → Intel
安装步骤
步骤 1：下载 DMG 文件
从 GitHub Releases 页面下载对应版本的 .dmg 文件。
验证文件完整性（推荐）：
shasum -a 256 openclaw-desktop-mac-arm64.dmg
步骤 2：安装应用
- 双击
.dmg文件，Finder 中出现挂载的镜像窗口 - 将 Openclaw 图标拖拽到 Applications（应用程序） 文件夹
- 弹出镜像：右键 Dock 中的磁盘图标 → 推出 Openclaw
步骤 3：处理 Gatekeeper 安全提示
由于 Openclaw 使用独立发布渠道，macOS Gatekeeper 首次打开时会提示"无法打开"。
标准处理方法：
- 在 Finder 中找到 Openclaw.app
- 按住 Control 键，单击 Openclaw 图标
- 在弹出菜单中选择打开，再次点击打开
或通过终端一次性解除隔离：
xattr -d com.apple.quarantine /Applications/Openclaw.app
macOS Sequoia（15.x）用户：进入系统设置 → 隐私与安全性，在页面底部找到 Openclaw 的提示，点击仍要打开。
macOS 首次配置
配置 AI 模型
| 使用场景 | 推荐模型 |
|---|---|
| 日常对话与写作 | Claude Sonnet 4.6 |
| 复杂推理与长文档 | Claude Opus 4.6 |
| 快速响应、高频使用 | Claude Haiku 4.5 |
| 本地隐私（无需 API） | Ollama + Qwen 或 Llama |
权限授权
| 功能 | 所需权限 |
|---|---|
| 截图发 AI | 屏幕录制权限 |
| 全局快捷键 | 辅助功能权限 |
| 通知 | 通知权限 |
授权辅助功能权限（全局快捷键必需）：
系统设置 → 隐私与安全性 → 辅助功能 → 找到 Openclaw，打开开关
macOS 专属功能
Apple 密钥链存储
Openclaw 使用 **Apple 密钥链（Keychain）**存储 API Key：
- API Key 受 macOS 密钥链加密保护，可通过 Touch ID 授权访问
- 其他应用无法读取 Openclaw 的 API Key
- 可在钥匙串访问应用中查看和管理
Touch ID 快速解锁
在设置 → 安全中启用 Touch ID 保护，每次启动 Openclaw 时使用指纹验证。
Spotlight 搜索集成
启用后，可通过 Spotlight（Cmd + Space）直接搜索 Openclaw 的对话历史，按 Enter 直接在 Openclaw 中打开。在设置 → 集成 → Spotlight 中开启。
macOS 菜单栏集成
Openclaw 图标常驻菜单栏（屏幕顶部右侧），单击显示快速操作菜单：快速发问、切换模型、查看最近对话。
多显示器支持
Openclaw 记住每台显示器上的窗口位置，在多显示器环境中可固定在副屏工作。
macOS 快捷键参考
| 操作 | 快捷键 |
|---|---|
| 唤起/隐藏主窗口 | Cmd + Shift + Space |
| 发送剪贴板内容 | Cmd + Shift + C |
| 截图发 AI | Cmd + Shift + S |
| 翻译选中文字 | Cmd + Shift + T |
| 新建对话 | Cmd + N |
| 搜索历史对话 | Cmd + F |
| 切换模型 | Cmd + M |
| 设置 | Cmd + , |
常见问题排查（macOS）
问题：首次打开提示"无法打开，因为无法验证开发者"
按照"步骤 3"处理。如 macOS Sequoia 仍无法打开，临时关闭 Gatekeeper：
sudo spctl --master-disable
# 安装完成后重新开启：
sudo spctl --master-enable
问题：全局快捷键不响应
进入系统设置 → 隐私与安全性 → 辅助功能，确认 Openclaw 已开启。如已开启但不生效，尝试关闭再重新开启，然后重启 Openclaw。
问题：Apple Silicon Mac 上运行缓慢
在活动监视器中查看 Openclaw 进程，"类型"列应显示"Apple"而非"Intel"。如显示"Intel"，需重新下载 ARM64 版本安装。
问题：截图功能提示权限被拒绝
进入系统设置 → 隐私与安全性 → 屏幕录制，确认 Openclaw 已开启。
卸载 Openclaw（macOS）
方法一：将 Finder 应用程序文件夹中的 Openclaw.app 拖入废纸篓。
方法二：通过 Homebrew（如通过 brew 安装）
brew uninstall --cask openclaw
清理用户数据（可选）：
rm -rf ~/Library/Application\ Support/Openclaw
rm -rf ~/Library/Preferences/ai.openclaw.*
rm -rf ~/Library/Caches/Openclaw
密钥链中的 API Key 需手动在钥匙串访问应用中删除（搜索"openclaw"）。