开篇

一、安装前准备（必看！）

1. 系统要求

Windows：Windows 10/11 64 位（推荐 21H2+）

macOS：12.0+（Monterey），支持 M1/M2/M3 与 Intel

内存：最低 4GB，推荐 8GB

磁盘：至少 500MB 空闲空间

2. 必须依赖（提前装好）

Node.js ≥ v22.0.0

（必须 22+，否则安装失败）open-claw.org.cn

Git（拉取源码 / 安装脚本用）open-claw.org.cn

包管理器：pnpm（官方强制推荐，npm 易卡死）open-claw.org.cn

3. 国内网络优化（关键！否则慢 / 失败）

#设置pnpm镜像为淘宝源（必执行）pnpm config set registry https://registry.npmmirror.com/

二、Windows 本地安装（两种方法，任选其一）

✅ 方法一：一键脚本安装（新手首选，5 分钟搞定）

以管理员身份打开 PowerShell（右键开始菜单→PowerShell (管理员)）

复制执行一键安装命令：

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

脚本会自动：

安装完成后，终端输入启动命令：

openclaw onboard

✅ 方法二：源码编译安装（适合想自定义 / 改代码）

打开 PowerShell，依次执行：

#1. 克隆国内镜像（速度快）git clone https://gitee.com/OpenClaw-CN/openclaw-cn.gitcd openclaw-cn# #2. 安装依赖pnpm install# 3. 构建前端UIpnpm ui:build# 4. 启动服务pnpm run openclaw onboard

三、macOS 本地安装（Apple Silicon/Intel 通用）

1. 先装 Homebrew（没装的话）

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

2. 安装依赖

#安装 Gitbrew install git# 安装 Node.js 22+（推荐LTS）brew install node@22# 安装 pnpmnpm install -g pnpm

3. 一键安装 OpenClaw

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

4. 启动

openclaw onboard

四、首次配置与使用（1 分钟上手）

打开浏览器：http://localhost:11434

注册 / 登录本地账号（无需外网）

接入 AI 模型（二选一）：

新建 “技能” 或 “自动化任务”，即可开始使用。

五、常见坑与避坑（90% 人卡在这里）

❌ 坑 1：Node.js 版本不够

报错：requires Node.js >=22.0.0

解决：用 nvm 安装 v22+

#安装nvm（macOS/Linux）curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bashnvm install 22nvm use 22

❌ 坑 2：pnpm 下载依赖卡死 / 超时

原因：没设国内镜像

解决：执行镜像命令（前文已给），或换网络重试open-claw.org.cn。

❌ 坑 3：启动后 Gateway 一直 “就绪中”

原因：端口占用 / 依赖未构建

解决：

❌ 坑 4：权限不足（macOS/Linux）

解决：命令前加sudo（谨慎使用），或用 nvm 免 root 安装。

六、总结