OpenClaw安装教程

系统要求与环境准备

硬件要求

软件依赖

OpenClaw 需要以下软件环境：

• Node.js：版本 22 或更⾼
• npm：Node.js 包管理器
• Git：版本控制⼯具（可选）
• Docker：容器化部署（可选）

前置检查

在安装前，检查系统是否满⾜要求：

node --version # 应显⽰ v22.x.x 或更⾼
npm --version # 应显⽰ 10.x.x 或更⾼
git --version # 检查 Git 版本

Windows 部署

安装 Node.js

⽅法⼀：官⽅安装包

1. 1. 访问 Node.js 官⽹（nodejs.org）
2. 2. 下载 LTS 版本安装包
3. 3. 运⾏安装程序，注意勾选"Add to PATH"

⽅法⼆：使⽤ nvm-windows

nvm install 22
nvm use 22

安装 OpenClaw

方式一：打开 PowerShell（推荐以管理员⾝份运⾏），执⾏：

iwr -useb https://openclaw.ai/install.ps1 | iex

国内⽤⼾可以使⽤镜像源：

iwr -useb https://clawd.org.cn/install.ps1 | iex

方式二：npm方式(推荐)

Image

打开页面如下：

Image

Image

继续如下：

Image

配置模型信息

Image

Image

Image

Image

Image

Image

Image

Image

Image

运⾏配置向导

安装完成后，运⾏配置向导：

openclaw onboard --install-daemon

按照提⽰完成配置：

1. 1. 使⽤ GitHub 账号登录
2. 2. 配置 AI 模型 API Key
3. 3. 选择通讯平台
4. 4. 安装系统服务

启动服务

openclaw gateway start

或者打开 Web 控制台：

openclaw dashboard

macOS 部署

使⽤ Homebrew 安装

Homebrew 是 macOS 上最流⾏的包管理器，推荐优先使⽤：

安装 Homebrew（如果尚未安装）：

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

安装 Node.js：

brew install node@22

安装 OpenClaw：

curl -fsSL https://openclaw.ai/install.sh | bash

Mac Mini 部署优化

Mac Mini 是运⾏ OpenClaw 的理想设备，以下是优化建议：

禁⽤睡眠：

sudo pmset -a sleep 0 displaysleep 0 disksleep 0

保持运⾏：

caffeinate -d -i -s &

配置本地模型（可选）：

brew install ollama
ollama pull qwen2.5-coder:14b

Apple Silicon 优化

对于 M1/M2/M3/M4 芯⽚的 Mac，本地模型运⾏效率更⾼：

Apple Silicon 本地模型推荐