1. MacBook环境准备与基础工具配置
在MacBook上部署OpenClaw前,需要确保开发环境的基础工具链完整。现代macOS系统虽然预装了UNIX工具集,但仍需针对性配置几个关键组件:
1.1 终端工具检查与升级
首先打开终端(Terminal.app或iTerm2),执行以下命令验证基础工具版本:
bash复制git --version
curl --version
- 若未安装Git,推荐通过Homebrew安装:
brew install git - macOS自带的curl版本可能较旧,建议升级:
brew install curl && echo 'export PATH="/usr/local/opt/curl/bin:$PATH"' >> ~/.zshrc
注意:从macOS Catalina开始默认使用zsh作为shell,若仍在使用bash需将上述命令中的
.zshrc改为.bash_profile
1.2 开发环境依赖补全
OpenClaw的编译过程需要Xcode命令行工具:
bash复制xcode-select --install
安装完成后验证:
bash复制clang --version
make --version
若出现"command not found"错误,需通过App Store完整安装Xcode后再次尝试。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. Node.js环境精准配置
OpenClaw对Node.js版本有严格要求(≥22),推荐使用Node Version Manager(nvm)进行多版本管理。
2.1 nvm安装的三种方案对比
方案一:官方源安装(国际网络环境适用)
bash复制curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
该命令会:
- 下载安装脚本到临时目录
- 创建
~/.nvm目录 - 修改shell配置文件(.zshrc/.bash_profile)
方案二:国内镜像加速
当官方源访问不稳定时,可使用国内镜像:
bash复制git clone https://gitee.com/mirrors/nvm.git ~/.nvm && cd ~/.nvm && git checkout v0.40.3
随后手动添加环境变量:
bash复制echo 'export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"' >> ~/.zshrc
方案三:brew安装(适合已配置Homebrew的用户)
bash复制brew install nvm
mkdir ~/.nvm
echo 'export NVM_DIR="$HOME/.nvm
