2026-03-07 14:33:37

OpenClaw怎么安装?

一、环境准备

1. 系统与硬件要求

• 操作系统:macOS、Linux、Windows(推荐WSL2)

• 最低配置:CPU≥2核,内存≥4GB,磁盘预留≥10GB空间

• 必备工具:Node.js ≥22、Git、Docker(可选,推荐用于沙箱隔离)

2. Node.js安装(核心依赖)

这是最关键的一步,版本不对后面全是坑!

二、Windows系统安装:

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

免费下载
免费下载
小程序
小程序
小程序
交流群
交流群
交流群
回顶部