macOS 部署 OpenClaw

本文教你从零在 macOS 上部署 OpenClaw：硬件与系统要求、Homebrew、nvm + Node.js、国内镜像源、git，最后安装并初始化 openclaw。

硬件要求

  • CPU：M 系列芯片或 Intel i5 以上
  • 内存：8GB 以上（推荐 16GB）
  • 硬盘：10GB 以上空闲空间

系统版本：

  • macOS 12 Monterey 或更高版本
  • 推荐 macOS 14 Sonoma 或 macOS 15 Sequoia

环境准备

安装 Homebrew

国内推荐使用 HomebrewCN 脚本（安装时选择阿里源）：

/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

常见错误点击这里查看

也可以使用官方安装脚本：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

验证 Homebrew：

brew -v

安装 Node.js（nvm）

安装 nvm：

brew install nvm

设置环境变量，编辑 ~/.zprofile：

vim ~/.zprofile

将以下内容添加到 .zprofile 文件最后面：

export NVM_DIR="$HOME/.nvm"
[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"  # 加载 NVM
[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"

按 ESC + :wq 保存并退出编辑器。

加载环境变量到当前终端：

source ~/.zprofile

接下来使用 nvm 安装 Node.js：

nvm install 22

配置 NVM 镜像源（加速 Node 下载）

安装好 NVM 后，将节点镜像地址设置为国内源。

临时设置（当前终端有效）：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node  # 淘宝源
# 或
export NVM_NODEJS_ORG_MIRROR=https://mirrors.ustc.edu.cn/node/    # 中科大源

永久设置：

将上述 export 命令添加到你的 Shell 配置文件（.bashrc、.zshrc 或 .bash_profile）中。

验证 Node.js 版本

# Verify the Node.js version:
node -v # Should print "v22.14.0".

# Verify npm version:
npm -v # Should print "11.9.0".

切换 npm 到国内淘宝镜像：

npm config set registry https://registry.npmmirror.com
npm config get registry

安装 git

brew install git

验证 git 安装：

git -v

安装 OpenClaw

npm i -g openclaw

验证安装：

openclaw --version

如果显示版本号就是安装成功。

运行以下命令初始化 openclaw：

openclaw onboard

验证部署

openclaw --version    # 输出版本号即安装成功
openclaw gateway      # 网关启动后，浏览器访问 http://127.0.0.1:18789/
  • openclaw onboard 向导完成后，在网页控制台能正常对话，说明部署成功
  • 网关服务异常时用 openclaw gateway restart 重启

参考