花了一整天时间，从装Node.js到跑通大模型，中间重启了3次电脑才搞定。这个OpenClaw的安装教程网上不少，但真正能一次过的没几个。下面把我踩过的坑和解决方法全部写出来，帮你省下这一天时间。
环境准备从Node.js开始
安装OpenClaw之前需要先配好基础环境。首先去Node.js官网下载24.14.0 LTS版本，注意版本必须在22以上，否则后面会报错。下载后一路点下一步就行，不用改任何设置。装完后打开电脑的命令提示符窗口，输入node -v查看版本号是否正确，再输npm -v检查npm是否安装成功。这两个命令都显示出版本数字，说明Node.js装好了。
如果你的需求只是使用最新模型，而不是自己折腾部署环境，也可以直接使用api.
接下来要安装包管理工具。在命令提示符窗口输入npm install -g pnpm，等待进度条跑完。如果你用的是Windows系统，还需要以管理员身份打开PowerShell，输入wsl --install来安装Linux子系统。官方文档说重启一次就行，但根据我的实际操作，可能需要重启两到三次电脑才能生效。重启之后系统会自动弹出安装Ubuntu的界面，耐心等待进度条走完。
Linux子系统的完整配置
电脑重启后会弹出PowerShell面板自动安装Ubuntu操作系统。如果没有自动弹出，可以手动在管理员PowerShell中输入wsl --install -d Ubuntu-24.04。如果这条命令报错，比如提示版本信息相关的问题，就重复上面的重启步骤。下载过程中会显示进度条，下载完成后需要设置用户名和密码。
特别注意：为了你的隐私安全，输入密码时屏幕上不会显示任何字符，这是正常现象。创建成功后，以后每次想进入Linux界面，只需要在管理员PowerShell中输入wsl就行。另外还需要安装Git，去官网下载安装包，安装时保持默认选项即可。安装完成后在命令提示符中输入git -v查看版本号。
OpenClaw核心安装步骤
打开管理员PowerShell，先输入wsl进入Linux系统。然后输入curl -fsSL
安装脚本运行完毕后，会进入大模型选择界面。这里以千问大模型为例进行说明，因为它是免费使用的。如果你有其他大模型的付费版本，也可以选择对应的选项。选择完成后，安装程序会给出一个本地地址，打开浏览器输入这个地址，按照提示登录账号。如果没有账号，注册一个就行。认证成功后，所有选项都保持默认设置。
解决systemd配置难题
WSL 2默认关闭了systemd功能，这是导致很多服务无法启动的根本原因。需要通过配置文件永久启用它。先在WSL终端中输入sudo nano /etc/wsl.conf，这会打开一个编辑界面。在编辑器中输入启用systemd的配置内容，注意格式要严格正确，不要有多余空格。
输入完成后，按键盘上的Ctrl加O组合键保存文件，再按Ctrl加X退出编辑器。然后需要在Windows主机上重启WSL，不是在WSL终端里操作。先关闭所有WSL终端窗口，打开电脑的开始菜单搜索CMD并打开，执行命令终止所有WSL实例。重新打开Ubuntu终端后，执行命令检查systemd核心进程是否运行。如果输出中包含State: running，说明配置成功了。
用户级服务永久运行设置
即使系统级systemd已经启用，用户级服务仍然可能因为用户登出而停止。这就需要启用lingering功能，让用户服务独立于用户会话永久运行。在WSL终端中执行启用lingering的命令，$(whoami)这部分会自动替换成你的用户名。
执行完命令后，需要验证lingering是否启用成功。检查当前用户的lingering状态，看到正常运行的提示就说明设置正确。这一步是OpenClaw Gateway服务正常工作的关键，如果跳过或者设置失败，后面会遇到各种奇怪的问题。完成所有配置后，建议再重启一次WSL会话，确保所有设置都生效了。
验证安装和常见问题处理
全部安装完成后，建议逐项检查验证。在WSL终端中输入特定命令查看OpenClaw服务状态，确认服务正在运行。如果遇到服务无法启动的情况，多半是systemd配置有问题，可以重新检查wsl.conf文件的内容是否正确。另外注意Node.js版本必须在22以上，版本太低会导致依赖安装失败。
整个安装过程中最常遇到的问题是重启次数不够。官方说重启一次，但实测需要两到三次。还有就是密码输入时不显示字符，很多人以为没输进去，实际是正常的。如果你按照上面的步骤一步步操作，应该能顺利跑通。安装完成后就可以开始使用大模型了。
你在安装过程中遇到的最奇怪的报错是什么？欢迎在评论区分享你的踩坑经历，点赞收藏让更多人看到这份避坑指南。
