OpenClaw+DeepSeek 本地部署教程：WSL2环境超详细指南
WSL2 搭配 Node.js24 部署 OpenClaw 完整教程｜国内源加速 + 开启 systemd
本教程基于 WSL2 Ubuntu 环境，完整演示从零安装到配置 OpenClaw 的每个步骤。重点解决下载卡顿、网关启动失败、权限异常等常见坑点——所有操作均可直接复现，无需额外调优。
一、环境前置：安装 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，未启用则直接启动失败。
- 编辑配置文件
sudo vim /etc/wsl.conf填入配置内容：
[boot]
systemd=true- 修改文件权限
sudo chmod 644 /etc/wsl.conf- 重启 WSL 生效
exit以管理员身份打开 Windows PowerShell，执行关机命令：
wsl --shutdown- 重启终端后校验状态
systemctl --user status显示 running 即为开启成功。
五、网关注册、启停与设备授权
1. 注册系统服务并设置开机自启
openclaw gateway install
systemctl --user start openclaw-gateway.service
systemctl --user enable openclaw-gateway.service2. 查看本地密钥凭证
配置文件中包含专属 Token，用于平台对接绑定：
cat ~/.openclaw/openclaw.json3. 网关启停与状态查看
openclaw gateway start
openclaw gateway status4. 设备连接授权
外网设备首次接入网关需手动审批，替换设备标识后执行授权：
openclaw devices approve xxxxx六、端口冲突导致 token 错误（如果上面第 5 步报错）
新服务尝试启动 → 端口被占用 → 启动失败 → 认证失效。若上一步骤 3 和 4 出现错误，按以下步骤处理。
附，若此处报错：
执行：
- 添加端口号：
vim ~/.openclaw/openclaw.json
- 重新安装网关服务（强制刷新端口）
openclaw gateway install --force- 重启服务
openclaw gateway stop
systemctl --user daemon-reload
openclaw gateway start- 查看状态
openclaw gateway status- 打开面板，复制到浏览器
openclaw dashboard --no-open
openclaw doctor --generate-gateway-token
cat ~/.openclaw/openclaw.json
openclaw devices approve xx七、对接 DeepSeek 模型并功能验证
1. 初始化模型接入配置
openclaw onboard2. 交互测试
发送测试指令，正常返回应答即表示整套部署完成：
openclaw agent --message "你好" --session-id test3. 命令行交互聊天
openclaw tui