





1. 系统与硬件要求
• 操作系统:macOS、Linux、Windows(推荐WSL2)
• 最低配置:CPU≥2核,内存≥4GB,磁盘预留≥10GB空间
• 必备工具:Node.js ≥22、Git、Docker(可选,推荐用于沙箱隔离)
2. Node.js安装(核心依赖)
这是最关键的一步,版本不对后面全是坑!

1. 打开Node.js官网:https://nodejs.org/zh-cn/download/current/(https://nodejs.org/zh-cn/download/current/)
2. 下载“Windows Installer (.msi)”64位版本
3. 双击安装包,务必勾选“Add Node.js to PATH”
4. 一路点击“Next”完成安装
5. 验证安装:按下Win+R,输入“cmd”打开命令提示符,执行:
node -v # 输出如v22.11.0即为成功
npm -v # 输出如10.2.4即为成功
macOS系统安装:
# 安装Homebrew(已安装则跳过)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 通过Homebrew安装Node.js
brew install node@22
# 验证安装
node -v && npm -v
Linux系统安装(以Ubuntu为例):
# 更新系统源
sudo apt update && sudo apt upgrade -y
# 添加NodeSource源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装Node.js
sudo apt install -y nodejs
# 验证安装
node -v
方式1:本地全局安装(推荐新手/个人使用)
这是最便捷的方式,全程可视化配置:
# 全局安装OpenClaw
npm install -g openclaw
# macOS/Linux若提示“权限不足”,执行:
sudo npm install -g openclaw
方式2:Docker容器安装(推荐多环境测试/洁癖用户)
Docker安装可避免污染系统环境:
# 拉取OpenClaw官方镜像
docker pull openclaw/openclaw:latest
# 创建配置目录(避免容器删除丢失配置)
mkdir -p ~/.openclaw
# 启动Docker容器
docker run -d \
-v ~/.openclaw:/root/.openclaw \ # 映射配置目录到宿主机
-p 3000:3000 \ # 映射网页管理端端口
--name openclaw \ # 给容器命名
--restart=always \ # 开机自启
openclaw/openclaw:latest
方式3:源码安装(推荐开发者/二次开发)
适合需要修改源码、扩展功能的用户:
# 克隆源码仓库
git clone https://github.com/openclaw/openclaw.git
# 进入源码目录
cd openclaw
# 安装项目依赖(需等待几分钟,确保网络稳定)
npm install
# 启动开发模式
npm run dev
