OpenClaw安装部署准备工作：前置检查+工具下载+环境配置避坑指南

部署前的准备工作，直接决定后续能不能一次成功！本章按「前置自检→工具下载→分系统环境→报错速解→总结预告」的逻辑梳理，全程精简不啰嗦。

一、前置7项硬核自检（必做！）

1. 硬件要求

项目	最低要求	推荐配置
内存	2GB	4GB+
硬盘	系统盘留1GB空闲	多留空间，优先用SSD
CPU	x64双核及以上	普通入门级CPU完全够用

⚠️ 32位系统用不了，直接pass

2. 系统版本对照

系统	版本要求	备注
Windows	10/11 64位	专业版/企业版最稳
MacOS	13+（Ventura及以上）	Intel/M1/M2/M3均可
Linux	Ubuntu 22.04 LTS+	首推22.04

⚠️ Windows家庭版不支持Hyper-V，直接开启WSL2即可

二、Hyper-V开启步骤（Windows专业版）

方法一：图形化操作（推荐新手）

1. 打开「设置」→「系统」→「高级」→「虚拟工作区」
2. 勾选四个开关：
   • Hyper-V GUI 管理工具
   • Windows PowerShell 的 Hyper-V 模块
   • Hyper-V 虚拟机监控程序
   • Hyper-V 服务
3. 点击确定，重启电脑

方法二：命令行（管理员PowerShell）

dism.exe /online /enable-feature /featurename:Microsoft-Hyper-V-All /all /norestart

三、NVM/Node环境配置

安装NVM for Windows

# 下载安装
winget install CoreOS.WSL

# 验证安装
nvm version

安装Node.js

# 安装最新版
nvm install latest

# 切换使用
nvm use 20.0.0

# 验证
node -v
npm -v

四、常见报错速解

报错	解决方案
端口18789被占用	netstat -ano | findstr :18789 → taskkill /PID xxx /F
WSL2安装失败	开启「虚拟机平台」功能后重试
Node版本不兼容	使用NVM切换到20+版本