小白玩转 OpenClaw 系列:WSL 安装踩坑记,不如直接装 Windows
最近有朋友问我,OpenClaw 装在 WSL 里到底好不好用?
我的回答是:能不用 WSL,就别用


官方推荐 WSL,但有些话没说全
官方文档确实推荐在 WSL 里安装 OpenClaw,理由也很充分:
兼容性好,类 Unix 环境更接近服务器
开发体验佳,命令行工具齐全
避免 Windows 路径和权限问题
这些话都没错,但官方没告诉你的是:WSL 虽然适合开发,但作为日常使用的桌面工具,它会遇到一些意想不到的麻烦。



WSL 安装的两大痛点
痛点一:文件访问麻烦
WSL 是一个隔离的 Linux 环境,它访问不到你 Windows 本地的文件。
什么意思?比如你想让 OpenClaw 读取你桌面上的某个配置文件,或者把生成的报告保存到我的文档里,在 WSL 里都需要做额外的挂载配置。
官方文档轻描淡写地说"可以挂载 Windows 目录",但实际操作起来:
需要配置 /etc/wsl.conf
需要处理权限问题
路径格式还特别别扭
对于小白用户来说,这已经是一道门槛了。


痛点二:浏览器控制不了
这才是最致命的。
OpenClaw 的一个核心功能是控制浏览器,帮你自动化操作网页。但当你把 OpenClaw 装在 WSL 里时,它和 Windows 本地的浏览器是两个世界。
WSL 里的程序要控制 Windows 的浏览器,需要做网络穿透、X11 转发、或者各种奇怪的配置。我按照网上教程折腾了整整一个下午:
试过设置 DISPLAY 环境变量
试过安装 VcXsrv
试过配置 WSLg
甚至试过在 WSL 里装 Firefox
结果要么是浏览器打不开,要么是打开了但控制不了,要么就是各种莫名其妙的错误。
我的解决方案:直接装 Windows
在 WSL 里折腾了几天后,我做了个决定:删了重装,直接装在 Windows 上。
然后世界清静了。
Windows 原生安装的 OpenClaw:
访问本地文件毫无障碍
控制浏览器丝滑流畅
不需要任何额外配置
所有在 WSL 里需要折腾半天的问题,在 Windows 上都不存在。
给小白的建议
如果你只是想用 OpenClaw 来:
控制浏览器自动化操作
管理本地文件
运行一些日常任务
那请直接安装在 Windows 上,不要犹豫。
WSL 更适合什么场景?适合你在服务器上部署 OpenClaw,或者你需要纯 Linux 环境做开发。但作为桌面工具,Windows 原生安装才是正解。
安装步骤(Windows 版)
安装 Node.js(官网下载 Windows 版)
打开 PowerShell,运行 npm install -g openclaw
运行 openclaw gateway start
完成
就这么简单,不需要任何额外配置。
总结
官方推荐 WSL,是从开发和部署角度考虑的。但作为桌面用户,我们的需求是简单、好用、不折腾。
如果你已经在 WSL 里装好了,而且一切正常,那继续用没问题。但如果你还没开始,或者正在 WSL 里遇到各种奇怪的问题,不妨试试直接装在 Windows 上。
有时候,官方推荐的不一定是最适合你的。
📖 本文属于【小白玩转 OpenClaw】系列
系列文档合集: https://docs.qq.com/sheet/DRmVtdVJhQVpwVWF0?tab=BB08J2
作者声明本文无利益相关,欢迎值友理性交流,和谐讨论~

校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案
校验提示文案