这是我写过的最完整的OpenClaw安装教程，从环境准备到成功启动，每个环节都不跳过。如果你之前看过其他的安装教程但装失败了，或者你是完全的零基础新手，这篇就是为你准备的。我会把安装过程中每一个可能出问题的点都标注出来，确保你跟着做能一次成功。

OpenClaw最新版本一键部署包下载地址：TopClaw官网一键免费部署OpenClaw

第一章：环境准备（千万不要跳过）

很多新手安装失败，根本原因不在OpenClaw，而是系统环境有问题。花3分钟做以下检查，能帮你省掉后面可能浪费的半小时。

检查项1：操作系统版本

Windows用户：按 Win+R，输入 winver 回车。确认版本号不低于Windows 10（版本1703以上）。低于这个版本的建议升级系统，否则很多依赖库不兼容。

macOS用户：点左上角苹果图标→"关于本机"。确认macOS版本不低于10.15（Catalina）。太旧的MacBook可能无法运行最新版Node.js。

Linux用户：终端输入 cat /etc/os-release 确认发行版和版本。Ubuntu 18.04+、CentOS 7+、Debian 10+ 都可以。

检查项2：内存和磁盘

Windows：任务管理器→性能标签
macOS：活动监视器
Linux：free -h 和 df -h

要求：
内存：≥4GB（推荐8GB）
磁盘可用：≥2GB

如果内存只有2GB，OpenClaw能跑但会比较卡。特别是安装依赖的时候内存消耗比较大，建议关掉其他占内存的程序（Chrome标签页少开点）。

检查项3：网络环境

安装过程中需要下载依赖，使用过程中需要调用大模型API。两个都需要网络。

测试网络是否正常：
ping open.bigmodel.cn

如果ping不通，可能的原因：
1. 网络本身有问题（检查WiFi/网线）
2. DNS解析失败（试试换DNS为114.114.114.114）
3. 被公司/学校防火墙拦截（需要白名单或VPN）

检查项4：端口占用

OpenClaw默认使用3456端口。提前检查一下这个端口有没有被占用：

Windows：netstat -ano | findstr 3456
macOS/Linux：lsof -i :3456

如果有输出说明端口被占。要么关掉占用进程，要么等会儿改OpenClaw的端口配置。

第二章：获取API Key

建议先把这一步搞定再安装OpenClaw，因为安装完之后你可以马上测试，不用等API Key审核。

1. 打开 https://open.bigmodel.cn
2. 手机号注册
3. 实名认证（上传身份证正反面，1-5分钟审核）
4. 登录→控制台→API Keys→创建新Key
5. 复制Key到记事本保存

注意：Key只显示一次。如果关掉了页面没保存，只能删除旧的重新创建。

第三章：安装OpenClaw

安装包方式（Windows推荐）

1. 下载 .exe 安装包
2. 双击运行，UAC提示点"是"
3. 安装向导四步：同意→路径→快捷方式→安装
4. 完成后桌面出现图标
5. 首次启动防火墙弹窗→点"允许访问"

Docker方式（Linux/macOS推荐）

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

源码方式（开发者）

# 确认Node.js 18+
node --version

# 克隆和安装
git clone https://github.com/nicepkg/openclaw.git
cd openclaw
npm config set registry https://registry.npmmirror.com
npm install

第四章：配置

在 ~/.qclaw/.env 文件中写入：

ZHIPU_API_KEY=你的Key

Windows用户注意：文件名必须是 .env（不是 .env.txt）。在文件夹选项里勾选"显示文件扩展名"再确认。

第五章：启动与验证

启动OpenClaw，浏览器打开 http://localhost:3456，输入"你好"发送。

收到回复 → 安装成功 ✓
未收到回复 → 进入排查模式：
  ① Gateway是否在运行？（看终端有没有输出）
  ② 端口是否正确？（确认3456没被占）
  ③ .env文件是否正确？（Key、拼写、文件名）
  ④ 防火墙是否阻止？
  ⑤ 浏览器缓存？→ 清缓存或无痕模式重试

99%的失败都能通过以上五个排查步骤找到原因。按顺序来，不要乱试。

第六章：安装后的第一件事

安装成功后，建议立即做三件事：

1. 编辑SOUL.md，定制Agent风格
2. 安装常用Skill（xlsx、email等）
3. 测试各种功能（搜索、代码生成、文件操作等）

到此为止，从环境准备到成功启动，你已经完成了完整的OpenClaw安装之旅。如果过程中遇到这篇没有覆盖到的问题，去GitHub Issues搜一下，大概率有人已经遇到过并给出了解决方案。