Mac 本地部署 OpenClaw-CN 指南
OpenClaw 是一个运行在个人 PC 上的 AI 助手,支持通过聊天程序唤醒。本文介绍如何在 macOS 上搭建本地化版本,结合云端大模型使用。
一、环境准备
1. 检查 Node 版本
首先确认当前环境中的 Node 版本:
node -v
which node
2. 升级 Node 至 v22
建议使用 NVM 管理 Node 版本,确保兼容性:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
安装完成后会修改 shell 配置文件(如 ~/.zshrc)。关闭终端并重新打开后执行以下命令验证:
cat ~/.zshrc | grep nvm
若输出包含 export NVM_DIR="$HOME/.nvm" 等配置,说明安装成功。
3. 安装 Node 22
nvm install 22
验证安装结果:
node -v
which node
4. 清理旧版本
为避免冲突,建议卸载系统自带的旧版 Node:
sudo rm -rf /usr/local/bin/node
sudo rm -rf /usr/local/bin/npm
sudo rm -rf /usr/local/lib/node_modules
sudo rm -rf /usr/local/include/node
sudo rm -rf /usr/local/share/man/man1/node.1
二、包管理器配置
推荐使用 Pnpm 作为包管理器,配合国内镜像源加速下载。
npm config set registry https://registry.npmmirror.com
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com/
三、项目部署
1. 克隆仓库
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn
切换到最新分支或标签:
git tag
git checkout v2026.2.2-cn

