说真的,很多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的完整流程。其实一步步做下来并不复杂,关键是要按顺序来,别跳步骤。如果你在过程中遇到其他问题,可以评论区留言,我尽量帮你解答。

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐