📦 一、环境准备
1.1 安装 Homebrew(可选)
如果你还没有安装 Homebrew,打开终端执行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
1.2 安装 Node.js 和 nvm(推荐)
OpenClaw 需要 Node.js,建议使用 nvm 管理版本,并安装 LTS 版本。
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
# 重新加载配置
source ~/.zshrc
# 安装 Node.js v22 LTS
nvm install 22
nvm use 22
nvm alias default 22
# 设为默认
# 验证
node -v
npm -v
可能的问题:
nvm: command not found解决:重新打开终端,或执行source ~/.zshrc。
1.3 安装 Xcode 命令行工具(编译 native 模块需要)
xcode-select --install
如果已安装,会提示'已经安装'。
🚀 二、安装 OpenClaw
推荐使用 本地源码安装(避免全局权限问题,方便调试)。
2.1 下载源码
有两种方式:
- 下载 ZIP:
访问 https://github.com/openclaw/openclaw,点击'Code' → 'Download ZIP',解压到
~/openclaw。
Git 克隆(推荐):
git clone https://github.com/openclaw/openclaw.git
2.2 安装依赖
cd ~/openclaw
npm install
可能的问题:网络慢或失败 解决:设置 npm 国内镜像
npm config set registry https://registry.npmmirror.com
npm install
2.3 创建全局命令链接(可选)
如果你想在任何目录直接使用 openclaw 命令:
npm

