OpenClaw本地部署全攻略：WSL2 + Ubuntu + Node.js 22+ 环境搭建指南
上周六刚帮公司新来的实习生装完这套环境，他之前踩了整整三天的坑——虚拟机卡成PPT、WSL1装OpenClaw连个简单的技能插件都跑不动、Node.js版本死活不对。今天咱们就用对话形式，把从开启WSL2到登录OpenClaw的全流程讲透，所有避坑点都是我和实习生踩过无数次的。
小白：老周老周，我刚换了台16G内存的Windows 11本，想装OpenClaw本地练手，之前用VMware装Ubuntu，开个浏览器都卡，听说WSL2是最优解，快教教我！
老周：哈哈，16G内存用WSL2完全够用，我那台8G的老本都能跑个轻量的单节点集群。咱们一步一步来，先从开启WSL2和虚拟机平台开始。
小白：好的好的，开启这个难吗？
老周：Windows 11或者Windows 10 22H2及以上版本超级简单，直接在管理员模式的PowerShell里敲一行命令就行：wsl --install，敲完回车，它会自动开启WSL2、虚拟机平台，还会自动下载安装Ubuntu 22.04 LTS，重启电脑之后就能用了。
小白：那如果是旧版本的Windows 10呢？比如我家里那台还是21H2的。
老周：旧版本的话要先手动更新KB5004296补丁，然后再分两步开启：第一步在管理员模式的PowerShell里敲dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart开启WSL，第二步敲dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart开启虚拟机平台，重启电脑之后，再去微软商店下载Ubuntu 22.04 LTS或者24.04 LTS，推荐22.04，因为OpenClaw官方测试最多，兼容性最好。
小白：哦，原来如此，我家里那台回去先更补丁。那重启电脑之后，Ubuntu怎么配置啊？
老周：重启之后，第一次打开Ubuntu，它会让你设置用户名和密码，这个一定要记住，后面装软件、改配置都要用。设置完之后，第一步就是换国内源，不然下载软件慢得要死，我之前踩过换清华源但没更新密钥的坑，折腾了一下午。
小白：那怎么换源才不会踩坑啊？
老周：先备份原来的源，敲sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak，然后用编辑器打开原来的源，比如用nano：sudo nano /etc/apt/sources.list，把里面的内容全部删掉，换成清华源的Ubuntu 22.04 LTS的内容，换完之后按Ctrl+O保存，按Ctrl+X退出，然后敲sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3B4FE6ACC0B21F32更新密钥，最后敲sudo apt update && sudo apt upgrade -y更新软件列表和软件，这样就不会报错了。
小白：好的，换源我记住了。接下来是不是要装Node.js 22+啊？OpenClaw v2026.2.21 LTS要求的对吧？
老周：对，要求Node.js 22.0.0及以上版本，千万不要用apt直接装，Ubuntu 22.04 LTS的apt源里最高只有Node.js 20.x，不够用。我推荐用nvm安装，nvm是Node.js的版本管理工具，可以随时切换Node.js的版本，非常方便。
小白：那nvm怎么安装啊？
老周：在Ubuntu的终端里敲一行命令就行：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash，敲完回车，它会自动下载安装nvm，安装完之后要重启终端，或者敲source ~/.bashrc（如果用的是bash）或者source ~/.zshrc（如果用的是zsh）让配置生效，然后敲nvm --version检查一下是否安装成功，如果能显示版本号，就说明安装成功了。
小白：好的，nvm安装成功了，那怎么装Node.js 22+啊？
老周：敲nvm install 22，它会自动下载安装Node.js 22的最新LTS版本，安装完之后敲nvm use 22切换到这个版本，然后敲node --version和npm --version检查一下是否安装成功，如果能显示版本号，就说明安装成功了。
小白：哇，Node.js也装好了。接下来是不是要装Docker Desktop for Windows啊？
老周：对，OpenClaw的单节点集群是用Docker Compose部署的，所以必须装Docker Desktop for Windows，而且要开启WSL2后端，不然Docker命令在Ubuntu里用不了。
小白：那Docker Desktop for Windows怎么装啊？
老周：直接去Docker官网下载Windows版本的安装包，双击安装就行，安装的时候要勾选“Use WSL 2 based engine”，安装完之后重启电脑，然后打开Docker Desktop，点击右上角的设置图标，点击“Resources”，然后给Docker Desktop设置合理的资源限制，比如2核CPU，4G内存，20G磁盘，不然会占用太多Windows的资源，导致电脑卡。然后点击“WSL Integration”，把Ubuntu的WSL2集成打开，点击“Apply & Restart”重启Docker Desktop，重启完之后，在Ubuntu的终端里敲docker --version和docker compose version检查一下是否安装成功，如果能显示版本号，就说明安装成功了。
小白：好的，Docker也装好了。接下来是不是要装OpenClaw单节点集群了？
老周：对，终于到最后一步了。先在Ubuntu的终端里找一个你想放OpenClaw配置文件的文件夹，比如叫openclaw-local，然后进入这个文件夹，敲git clone https://github.com/openclaw-io/openclaw-docker-compose.git克隆官方的Docker Compose配置文件，克隆完之后进入openclaw-docker-compose文件夹，敲docker compose up -d一键部署，敲完回车，它会自动拉取OpenClaw的所有镜像并启动容器，第一次启动要等5-10分钟，因为要拉取很多镜像，你可以敲docker compose ps检查一下所有容器的状态，当所有容器的状态都是“Up”的时候，就说明部署成功了。
小白：哦，部署成功了！那怎么登录OpenClaw管理控制台啊？
老周：在Windows的浏览器里访问http://localhost:8080，默认账号是admin，密码是openclaw123，第一次登录后一定要修改密码，不然不安全。如果访问不了，先检查Docker容器的状态，看看有没有容器是“Exited”的，如果有，敲docker compose logs 容器名看看日志里有什么错误，然后再检查端口映射，看看8080、3000、6379、27017这些端口有没有被Windows的其他软件占用，如果被占用了，要修改docker-compose.yml里的端口映射。
小白：好的，我记住了。那如果我忘了密码怎么办啊？
老周：忘了密码也没关系，不要直接删MongoDB的容器，不然所有的配置都会丢失。先进入MongoDB的容器，敲docker compose exec mongodb mongosh，然后敲use openclaw切换到OpenClaw的数据库，然后敲db.users.updateOne({username: "admin"}, {$set: {password: "$2a$10$N9qo8uLOickgx2ZMRZoMyeIjZAgcfl7p92ldGxad68LJZdL17lhWy"}})重置密码为openclaw123，然后敲exit退出MongoDB的容器，就可以用新密码登录了。
小白：哇，太感谢老周了！我终于学会了！