OpenClaw本地部署:Windows WSL2方案详解
说真的,很多Windows用户一听到"Linux环境部署"就头大,觉得这是折腾人的事情。但自从WSL2推出以后,事情就简单多了——你在Windows里直接跑一个完整的Linux内核,不需要装双系统,也不需要开虚拟机,整个过程顺滑得不像话。最近不少朋友问我OpenClaw(龙虾)在Windows上怎么部署最省心,今天我就把WSL2这套方案从头到尾捋一遍,保证你照着做就能跑起来。
OpenClaw最新版本一键部署包下载地址:TopClaw官网一键免费部署OpenClaw
一、先确认你用的Windows版本
不是所有Windows都能跑WSL2的,这是个前提条件。你需要确保系统版本是Windows 10 2004(内部版本19041)或更高。怎么查?按Win+R,输入winver,回车。弹出来的窗口里会显示你的Windows版本和内部版本号。看到19041以上的数字就没问题。如果你还在用更老的版本……说实话,升级系统比折腾兼容性要省事得多。
二、启用WSL功能
打开PowerShell(管理员权限),执行下面这一行命令:
wsl --install
对,就这一行。它会自动帮你启用"适用于Linux的Windows子系统"和"虚拟机平台"两个功能,并且默认安装Ubuntu发行版。整个过程可能需要几分钟到十几分钟不等,取决于你的网速——因为它要从微软商店下载Ubuntu的包。如果你的网络环境访问微软商店比较慢,可以考虑换源或者用离线方式安装发行版,但这属于进阶操作了,后面有机会再单独讲。
安装完之后系统会要求你重启。重启是必须的,不重启WSL2的核心组件不会生效。重启完打开一个新的终端窗口,你应该会看到Ubuntu正在初始化,让你设置用户名和密码。这里设置的用户名和密码是Linux子系统内部的,跟你Windows的账户没关系。记住这个密码就行,后面sudo提权会用到。
三、确认WSL2已经在跑
进入Ubuntu终端之后,先验证一下WSL2是否正常工作。执行:
wsl -l -v
如果VERSION列显示的是2,说明WSL2已经就绪。如果显示的是1,说明还是WSL1,需要手动转换一下:
wsl --set-version Ubuntu 2
这个转换过程会花几分钟,耐心等它跑完就好。
四、在WSL2里准备Node.js环境
OpenClaw是基于Node.js运行的工具,所以你得先在WSL2里把Node.js环境搭好。推荐用nvm来管理Node版本,别直接用apt装系统的Node.js,那个版本往往比较旧,容易出现兼容性问题。
安装nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
装完之后关掉终端重新打开,确认nvm是否可用:
nvm --version
然后安装Node.js,推荐使用18.x的LTS版本:
nvm install 18
nvm use 18
node -v
npm -v
看到版本号输出就说明环境没问题了。
五、获取和安装OpenClaw
这一步就很简单了。你可以通过npm直接全局安装:
npm install -g openclaw
或者如果你想用最新的开发版本,也可以从源码编译安装。但说实话,对于大多数用户来说,npm安装就够了,简单省事。
安装完成之后,执行:
openclaw --version
能输出版本号说明安装成功了。接下来是初始化配置:
openclaw init
这个命令会引导你完成基础的配置流程,包括设置工作目录、选择默认的AI模型、配置API Key等。跟着提示一步步来就行,没什么难度。
六、目录映射和文件访问
WSL2有一个好处是你可以在Linux环境里直接访问Windows的文件系统。Windows的所有盘符都挂载在 /mnt/ 下面,比如你的C盘就是 /mnt/c/。这意味着你在Windows上用编辑器写的代码,可以直接在WSL2里用路径访问到。反过来也是一样,WSL2里的文件在Windows资源管理器的地址栏输入 \\wsl$ 就能看到。
不过有一点要注意:跨文件系统操作(比如在WSL2里读写/mnt/c/上的文件)性能会比在WSL2自己的文件系统里操作差不少。建议把OpenClaw的工作目录放在WSL2的home目录下(比如 ~/openclaw-workspace),需要处理Windows上的文件时再临时访问。
七、后台运行和自动启动
你可能会问,每次打开终端手动启动OpenClaw不太方便,能不能让它后台跑起来?当然可以。最简单的做法是用PM2:
npm install -g pm2
pm2 start openclaw --name "openclaw-agent"
pm2 save
pm2 startup
这样OpenClaw就会作为后台服务运行,即使你关掉了终端窗口也不会停。而且pm2 startup命令会生成一个开机自启的脚本,WSL2启动的时候会自动把之前保存的进程拉起来。
但这里有个坑需要说一下:WSL2本身不会在Windows开机时自动启动。你需要做一个小设置——在Windows的启动文件夹里放一个脚本,让Windows登录时自动执行wsl命令来启动WSL2。具体做法是在PowerShell里执行:
Invoke-WebRequest -Uri "https://github.com/CSDN-OpenClaw/wsl-startup/raw/main/wsl-boot.vbs" -OutFile "$env:APPDATA\Microsoft\Windows\Start Menu\Programs\Startup\wsl-boot.vbs"
这样每次Windows开机登录,WSL2就会静默启动,然后PM2会自动拉起OpenClaw服务。整个过程对你来说就是开机即用,感受不到中间这些环节。
八、网络配置注意点
WSL2的默认网络模式是NAT,也就是说WSL2里的服务监听的端口不会直接暴露给Windows主机。但在较新的Windows 11版本中,微软已经推出了mirrored网络模式,WSL2和Windows共享网络栈,互访不再有障碍。
如果你用的是比较新的系统,可以在用户目录下创建或编辑 .wslconfig 文件,加入以下内容:
[wsl2]
networkingMode=mirrored
保存后执行 wsl --shutdown 再重新打开WSL2就生效了。这个模式的好处是你不需要做端口转发,WSL2里跑的服务直接用localhost就能从Windows浏览器访问。
九、性能优化建议
WSL2默认会吃掉一部分内存和CPU资源,如果你的机器配置不高,可能会感觉有点吃力。你可以通过 .wslconfig 来限制WSL2的资源占用:
[wsl2]
memory=4GB
processors=2
根据你的机器配置灵活调整。对于OpenClaw来说,4GB内存和2个CPU核心基本够用了。如果后面要跑更重的任务,可以适当调高。
另外建议在WSL2里禁用不需要的systemd服务,减少后台资源消耗。比如如果你不需要在WSL2里跑桌面环境或者数据库,就把相关的服务停掉。
十、常见问题排查
最后说几个新手最容易踩的坑。第一个是权限问题——如果你在WSL2里操作文件报permission denied,大概率是因为文件在/mnt/下(属于Windows文件系统),WSL2里的文件权限模型跟Windows不一样。解决办法是把需要频繁修改的文件复制到WSL2的home目录下操作。
第二个是端口冲突——如果你Windows上已经装了某些服务占用了8080或3000端口,WSL2里再启动服务会报地址被占用。改一下端口或者关掉Windows上的冲突服务就行。
第三个是npm安装速度慢——国内网络访问npm registry可能不太稳定,建议在WSL2里切换到淘宝镜像源:npm config set registry https://registry.npmmirror.com。这一步能省你很多等待时间。
好了,以上就是WSL2部署OpenClaw的完整流程。其实一步步做下来并不复杂,关键是要按顺序来,别跳步骤。如果你在过程中遇到其他问题,可以评论区留言,我尽量帮你解答。
更多推荐


所有评论(0)