大家好，我是一名移动云售前工程师，与云、AI、通信相关的问题欢迎大家与我交流，如有移动云或其他产品需使用，可以通过私信与我联系。
好了，言归正传，下面是openclaw的windows下wsl2环境安装的教程。wsl2环境其实就是windows自带的虚拟机环境，如果要在windows里安装，目前官方比较推崇的也是在wsl2环境下安装。
安装教程
一、wsl环境安装
进入PowerShell管理员模式# 安装默认wsl环境
wsl --install
#或指定发行版（
wsl --install -d Ubuntu-24.04
等安装进度条结束后会进入输密码阶段，密码是不会显示的，输入结束直接回车即可。
进入系统后# 开启systemd（WSL2内）
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
关机
wsl --shutdown
重新进入wsl
wsl -d Ubuntu-24.04
二、进入 WSL 环境
在开始菜单或终端中启动已安装的 Ubuntu。为了加速后续的软件下载，建议参考清华大学 TUNA 官方文档，将软件源更换为国内镜像。
清华大学开源软件镜像站 清华大学开源软件镜像站 | Tsinghua Open Source Mirror
vi /etc/apt/sources.list
有可能出现权限不足的情况，在命令前面加上sudo或者更改用户的权限。
2026年4月22日镜像源地址，时间太久的话可以上网去搜，都有现成的。
# 默认注释了源码镜像以提高 apt update 速度，如有需要可自行取消注释
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-updates main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-updates main restricted universe multiverse
deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-backports main restricted universe multiverse
# deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-backports main restricted universe multiverse
# 以下安全更新软件源包含了官方源与镜像站配置，如有需要可自行修改注释切换
deb http://security.ubuntu.com/ubuntu/ noble-security main restricted universe multiverse
# deb-src http://security.ubuntu.com/ubuntu/ noble-security main restricted universe multiverse
# 预发布软件源，不建议启用
# deb https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-proposed main restricted universe multiverse
# # deb-src https://mirrors.tuna.tsinghua.edu.cn/ubuntu/ noble-proposed main restricted universe multiverse
其他镜像源地址：
镜像源
地址
腾讯云
mirrors.cloud.tencent.com
华为云
repo.huaweicloud.com
中科大源
mirrors.ustc.edu.cn
更换文本内容后进行软件升级操作
sudo apt update #刷新软件源索引
sudo apt upgrade -y #升级所有可更新软件包
三、配置镜像网络模式
镜像模式可使 WSL 直接使用 Windows 宿主机的网络接口，极大地简化了网络配置并提升了各种代理和端口的兼容性。
-
创建配置文件： 在 Windows 文件资源管理器中导航至 C:\Users\<你的用户名>\。若不存在 .wslconfig 文件，则新建一个（注意文件名以 . 开头）。
-
编辑配置： 用记事本打开该文件，填入以下内容：
[wsl2]
启用镜像网络模式
networkingMode=mirrored
启用 DNS 隧道，避免 VPN 环境下的 DNS 解析问题
dnsTunneling=true
自动使用 Windows 的 HTTP 代理设置
autoProxy=true
启用防火墙集成
firewall=true
[experimental]
自动回收闲置内存
autoMemoryReclaim=gradual
允许从 WSL 访问 localhost 等回环地址
hostAddressLoopback=true
应用配置与验证：保存文件后，在 PowerShell 中执行以下命令关闭 WSL：
wsl --shutdown
等待约 8 秒后重新启动 Ubuntu。进入 WSL 后，运行ip addr show，若配置成功，你将看到与 Windows 宿主机同网段的 IP 地址。
四、配置防火墙规则
若需要在 WSL 中运行服务并开放特定端口（例如OpenClaw使用的18789端口），可在 Windows PowerShell（管理员）中创建入站规则：
# 创建入站规则，允许指定端口
New-NetFirewallRule -DisplayName "OpenClaw-Service" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 18789
# 查看已创建的规则
Get-NetFirewallRule -DisplayName "OpenClaw-Service" | Format-Table
补充：若未来需要删除该防火墙规则，可以使用以下命令（将{Name}替换为上一步查询到的 Name 字段）：Remove-NetFirewallRule -Name "{Name}"
#如上命令中，OpenClaw-Service即是名称/Name。
五、安装必备依赖
-
Node安装（关键要求）
bashnode -v # 检查版本，必须≥22.0.0 npm -v # 检查npm版本
-
Git（源码安装时需要）
-
模型API Key：至少准备一个（Moonshot/MiniMax/Qwen/DeepSeek等）
安装基础工具
sudo apt install -y curl wget git
⭐️安装node（重要）
如果当前 Node 22.10.0 版本低于 openclaw 要求的 22.12.0，触发引擎不兼容警告。
Node 官方发布的 22 系列稳定版本不是 22.22.1，而是 v22.0.0、v22.1.0、v22.2.0 等，直接指定具体版本号即可跳过错误缓存。
以下命令二选一即可，根据自身网络环境使用：
中国大陆网络环境（使用 Gitee 镜像）# 使用 Gitee 镜像安装 NVM
curl -o- https://gitee.com/mirrors/nvm/raw/master/install.sh
国际网络环境（使用 GitHub）使用官方脚本安装 NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh
安装后配置
# 重新加载 shell 配置
source ~/.bashrc
# 或
source ~/.zshrc
# 验证安装
nvm --version
使用 NVM 安装 Node.js
# 安装最新 LTS 版本（直接输入这个也行，后面是安装指定版本）
nvm install --lts
# 查看可安装的 Node.js 版本
nvm ls-remote
# 安装特定版本（如 Node.js 22）
nvm install 22.8.0
# 安装最新版本
nvm install node
六、安装 OpenClaw
使用官方脚本安装通过运行官方提供的一键安装脚本进行快速部署：
curl -fsSL https://molt.bot/install.sh | bash
运行初始化向导安装完成后，执行初始化向导，并使环境变量生效：
openclaw onboard --install-daemon
source ~/.bashrc
PS：有时会出现安装卡住，长时间无动静，可以ctrl+c先退出安装，执行以下命令后重新安装。
切换国内npm镜像，执行命令
npm config set registry https://registry.npmmirror.com/
清理缓存
npm cache clean --force后重新安装
