1. 系统要求
注意： 在开始安装之前，请确保您的macOS系统满足以下最低要求。
- 操作系统：macOS 10.14 (Mojave) 或更高版本
- 芯片架构：
✅ Apple Silicon (M1/M2/M3)✅ Intel (x86_64)
- 内存：至少 4GB RAM（推荐 8GB 或更多）
- 磁盘空间：至少 500MB 可用空间
- 网络：稳定的互联网连接（用于下载依赖）
2. 芯片架构说明
macOS系统支持两种不同的芯片架构，安装方法略有不同：
| 芯片类型 | 特点 | 支持的设备 | 兼容性 |
|---|---|---|---|
| Apple Silicon | 苹果自研ARM架构芯片，性能优秀，能效比高 | 2020年及以后的Mac设备 | ✅ 原生支持 |
| Intel | 传统的x86_64架构芯片，兼容性好 | 2020年以前的Mac设备 | ✅ 完全兼容 |
检查您的芯片架构
打开"终端"应用，输入以下命令查看芯片信息：
# 检查芯片架构
uname -m可能的输出：
# Apple Silicon (ARM)
arm64
# Intel (x86_64)
x86_643. 安装方法（推荐）
根据您的偏好选择以下一种安装方法：
Homebrew安装
推荐 - 使用macOS最流行的包管理器，简单快捷
需要先安装Homebrew：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"然后安装OpenClaw：
brew install openclaw官方安装包
使用官方提供的DMG安装包，适合所有用户
- 访问官方下载页面
- 下载 macOS 版本的 DMG 文件
- 双击 DMG 文件挂载
- 将 OpenClaw 拖到"应用程序"文件夹
# 手动安装示例
chmod +x OpenClaw.app
sudo cp -R OpenClaw.app /Applications/源码编译
从源代码编译安装，适合开发者和需要自定义配置的用户
# 克隆代码仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw
# 编译安装
make
sudo make install
安全提醒： 只从官方网站或可信渠道下载安装包，避免使用未经验证的第三方来源。
4. 验证安装
安装完成后，按照以下步骤验证是否成功：
步骤1：检查版本
# 查看OpenClaw版本
openclaw --version预期输出示例：
OpenClaw version 2.1.0
Build date: 2026-03-10
Platform: macOS (arm64)步骤2：测试基本功能
# 查看帮助信息
openclaw --help
# 测试简单命令
openclaw info步骤3：验证文件权限
# 检查可执行文件权限
ls -la /usr/local/bin/openclaw
# 如果使用Homebrew安装
ls -la $(brew --prefix)/bin/openclaw
恭喜！ 如果上述命令都正常工作，说明OpenClaw已成功安装并可以使用！
5. 常见问题
Q1: 安装后无法找到openclaw命令？
A: 可能需要重新启动终端或将OpenClaw路径添加到PATH环境变量：
# 如果是DMG安装，确保程序在/Applications目录下
ls -la /Applications/OpenClaw.app
# 如果是源码安装，可能需要手动添加PATH
export PATH="/usr/local/bin:$PATH"
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrcQ2: 在Apple Silicon上运行报错？
A: 确保安装的是ARM64版本或使用Rosetta 2兼容模式：
# 检查是否运行在Rosetta下
sysctl -n sysctl.proc_translated
# 如果需要，可以为终端启用Rosetta
arch -x86_64 zshQ3: Homebrew安装失败怎么办？
A: 尝试更新Homebrew或手动下载安装：
# 更新Homebrew
brew update
brew upgrade
# 重新安装OpenClaw
brew reinstall openclaw6. 后续步骤
安装完成后，您可以继续以下步骤：