macOS 安装指南

macOS 是 OpenClaw 体验最完整的平台，支持 iMessage 集成和语音唤醒等独占功能。

快速安装

一键脚本（推荐）

curl -fsSL https://openclaw.ai/install.sh | bash

NPM 安装

npm install -g openclaw@latest
openclaw onboard --install-daemon

Homebrew

brew install openclaw
openclaw onboard --install-daemon

前置要求

Node.js 22+

# 推荐用 nvm 管理
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
source ~/.zshrc
nvm install 22

# 或用 Homebrew
brew install node@22

Apple Silicon (M1/M2/M3/M4) 兼容性

OpenClaw 完全兼容 Apple Silicon，无需 Rosetta。如果遇到原生模块编译问题：

# 确保使用 ARM64 版本的 Node.js
node -p process.arch  # 应显示 arm64

# 如果显示 x64，重新安装
nvm uninstall 22
arch -arm64 nvm install 22

配置 API Key

nano ~/.openclaw/.env

# 推荐 Claude（Agent 能力最强）
ANTHROPIC_API_KEY=sk-ant-xxx

# 或 OpenAI
OPENAI_API_KEY=sk-xxx

macOS 独占功能

iMessage 集成

macOS 上可以直接通过 iMessage 与 OpenClaw 对话：

# 启用 iMessage 渠道
openclaw channels add imessage

需要授予以下权限：

• 完全磁盘访问权限：系统设置 → 隐私与安全性 → 完全磁盘访问权限 → 添加终端/iTerm2
• 这是因为 iMessage 数据库存储在受保护的目录中

TIP

也可以通过 BlueBubbles 在非 Mac 设备上使用 iMessage 集成。

语音唤醒

macOS 和 iOS 支持语音唤醒词，免手动输入：

# 启用语音功能
openclaw config set voice.enabled true
openclaw config set voice.wakeWord "Hey Claw"

原生 macOS 应用

OpenClaw 提供原生 macOS 菜单栏应用，常驻后台：

# 安装桌面应用
openclaw install-app

功能：

• 菜单栏图标显示状态
• 快捷键呼出对话窗口
• 系统通知集成
• 开机自启动

守护进程管理

OpenClaw 使用 launchd 管理守护进程：

# 查看状态
openclaw gateway status

# 启动/停止/重启
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

# 查看日志
openclaw gateway logs
# 或
tail -f ~/Library/Logs/openclaw/gateway.log

常见问题

安装后命令找不到

# 检查 PATH
echo $PATH

# 如果用 nvm，确保 .zshrc 中有 nvm 初始化
cat ~/.zshrc | grep nvm

"无法验证开发者" 弹窗

安装原生应用时可能遇到 Gatekeeper 拦截：

# 方法一：系统设置 → 隐私与安全性 → 仍要打开
# 方法二：命令行移除隔离属性
xattr -d com.apple.quarantine /Applications/OpenClaw.app

iMessage 权限问题

如果 iMessage 集成无法读取消息：

1. 系统设置 → 隐私与安全性 → 完全磁盘访问权限
2. 添加你使用的终端应用（Terminal.app / iTerm2 / Warp）
3. 重启终端

Homebrew 安装的 Node.js 版本冲突

# 如果同时有 Homebrew 和 nvm 的 Node.js
brew uninstall node
# 只保留 nvm 管理的版本
nvm use 22

推荐开发环境

工具	推荐	说明
终端	iTerm2 / Warp	比自带 Terminal 更好用
Node 管理	nvm	多版本切换
编辑器	VS Code	编辑配置文件
Docker	OrbStack	比 Docker Desktop 更轻量