WSL2 搭配Node.js24部署OpenClaw完整教程｜国内源加速+开启systemd

本篇实操教程基于WSL2 Ubuntu环境，从零完成OpenClaw安装配置，针对性解决下载卡顿、网关启动失败、权限异常等常见问题，全程步骤可直接复刻执行。

对应视频教程链接： link

一、环境前置：安装Git与Node.js24

OpenClaw运行依赖Git与Node.js环境，先完成基础环境部署。

1. Windows端安装Git

下载地址：https://git-scm.com/install/windows

2. WSL内安装Node.js24

采用镜像压缩包方式安装指定版本，执行如下命令

# 拉取Node.js24安装包
wget https://cdn.npmmirror.com/binaries/node/v24.15.0/node-v24.15.0-linux-x64.tar.xz

# 解压部署至系统目录
sudo tar -xJf node-v24.15.0-linux-x64.tar.xz -C /usr/local --strip-components=1

版本校验

输出版本号即代表安装生效

node -v
npm -v

二、切换NPM国内镜像，规避下载超时

默认官方源访问速度慢，切换镜像提升安装效率，同时规避权限报错

# 配置阿里镜像源
npm config set registry https://registry.npmmirror.com

# 设定全局安装目录
npm config set prefix $HOME/.npm-global

# 写入环境变量并生效
echo 'export PATH=$HOME/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

三、全局安装OpenClaw核心程序

npm install -g openclaw

四、开启WSL2的systemd服务

网关注册运行必须依赖systemd，未开启会直接启动失败

1. 编辑配置文件

sudo vim /etc/wsl.conf

填入配置内容

[boot]
systemd=true

2. 修改文件权限

sudo chmod 644 /etc/wsl.conf

3. 重启WSL生效

exit

管理员身份打开Windows PowerShell，执行关机命令

wsl --shutdown

4. 重启终端后校验状态

systemctl --user status

显示running即为开启成功

五、网关注册、启停与设备授权

1. 注册系统服务并设置开机自启

openclaw gateway install
systemctl --user start openclaw-gateway.service
systemctl --user enable openclaw-gateway.service

2. 查看本地密钥凭证

配置文件内包含专属Token，用于平台对接绑定

cat ~/.openclaw/openclaw.json

3. 网关启停与状态查看

openclaw gateway start
openclaw gateway status

4. 设备连接授权

外网设备首次接入网关需手动审批，替换设备标识执行授权

openclaw devices approve xxxxx

六、端口冲突导致token错误（如果上面的5报错）

新服务想启动 → 端口被占 → 启不动 → 认证失效

如果上面3和4发生错误，就执行5.
附，如果此处报错：
执行：
1、添加端口号：vim ~/.openclaw/openclaw.json

2、重新安装网关服务（强制刷新端口）

openclaw gateway install --force

3、重启服务

openclaw gateway stop
systemctl --user daemon-reload
openclaw gateway start

4、查看状态

openclaw gateway status

5、打开面板，复制到浏览器

openclaw dashboard --no-open
openclaw doctor --generate-gateway-token
cat ~/.openclaw/openclaw.json
openclaw devices approve xx

七、对接DeepSeek模型并功能验证

1. 初始化模型接入配置

openclaw onboard

2. 交互测试

发送测试指令，正常返回应答即代表整套部署完成

openclaw agent --message "你好" --session-id test