写这篇文章的初衷很简单：网上关于OpenClaw安装的教程太多了，但质量参差不齐。有的过时了还在用旧版命令，有的漏了关键步骤导致读者卡住，有的直接就是互相搬运。所以这篇我会严格按照官方文档来写，把完整的安装流程从头到尾走一遍。

OpenClaw最新版本一键部署包下载地址：https://top.wokk.cn/

安装前的环境检查

不管你选哪种安装方式，先确认以下基本条件：

操作系统：Windows 10/11、macOS 10.15+、Ubuntu 18.04+
内存：至少4GB（推荐8GB）
磁盘空间：预留2GB
网络：能正常访问外网（安装依赖需要）

OpenClaw的安装方式有三种，按推荐度排序：

方式一：官方安装包（推荐所有人）
方式二：Docker镜像（推荐服务器用户）
方式三：源码编译（推荐开发者）
方式一：官方安装包

这是最简单的方式，适合95%的用户。下载对应系统的安装包，双击运行，全程点击"下一步"即可。

Windows用户：

1. 下载 OpenClaw-Setup-x64.exe
2. 双击运行，选择安装路径
3. 安装完成后桌面生成快捷方式

macOS用户：

1. 确认芯片类型：终端输入 uname -m
2. Intel芯片下载x86_64版本，Apple芯片下载arm64版本
3. 双击dmg文件，拖入Applications文件夹

Linux用户：
sudo dpkg -i openclaw_latest_amd64.deb
sudo apt-get install -f
方式二：Docker镜像

拉取镜像

docker pull nicepkg/openclaw:latest

创建配置目录

mkdir -p ~/.qclaw

运行容器

docker run -d
–name openclaw
–restart unless-stopped
-p 3456:3456
-v ~/.qclaw:/root/.qclaw
nicepkg/openclaw:latest

注意 -v 参数一定要加，否则容器删除后数据全丢。

方式三：源码编译

确认Node.js版本

node --version # 需要18+

克隆项目

git clone https://github.com/nicepkg/openclaw.git
cd openclaw

安装依赖

npm install

配置环境变量

cp .env.example .env

编辑.env填入API Key

启动

npm run gateway

国内用户记得配npm镜像：npm config set registry https://registry.npmmirror.com

安装后的首次配置

无论哪种安装方式，都需要配置API Key。在 ~/.qclaw/.env 文件中填入：

ZHIPU_API_KEY=你的Key

配置完成后启动Gateway，浏览器访问 http://localhost:3456。看到Web界面就说明安装成功了。

三种方式选一种适合自己的就行。新手选安装包，服务器选Docker，开发者选源码。就这么简单，不需要纠结。