本文最后更新于 2026-03-04，文章内容可能已经过时。

Windows 全场景 WSL2 + OpenClaw 运行环境完整安装教案

一份从零开始的完整指南，涵盖 WSL2 一键安装、自定义盘符安装、网络优化配置及 OpenClaw 部署全流程。

前置要求

硬件/软件要求

系统：Windows 10 2004 版本以上（内部版本 19041+）/ Windows 11 全版本
硬件：CPU 支持虚拟化（VT-x/AMD-V），内存≥8GB，目标磁盘剩余空间≥20GB
网络：能正常访问外网（或国内镜像源）

学习目标

学完本课程，你将掌握：

Windows 下 WSL2 的一键安装与验证
WSL2 自定义非系统盘安装的完整流程
适配 OpenClaw 的 WSL 环境优化配置
WSL 常见问题的排查与解决

第一章课前必做：环境前置检查

1.1 检查 Windows 系统版本

按下 Win + R，输入 winver 回车
核对版本要求：
- Windows 10：需显示「版本 2004 及以上」，内部版本号≥19041
- Windows 11：任意版本均符合要求

1.2 确认 CPU 虚拟化已开启

Ctrl + Shift + Esc 打开任务管理器
切换到「性能」选项卡 → 「CPU」
查看「虚拟化：已启用」

1.3 准备管理员权限终端

Win + X → 选择「Windows 终端（管理员）」
后续所有命令均在此窗口执行

第二章模块 A：新手零门槛一键安装 WSL2（系统盘 C 盘）

适用场景：C 盘剩余空间≥20GB，想最快速度完成安装

2.1 执行一键安装命令

wsl --install

命令核心作用：

✅ 启用「适用于 Linux 的 Windows 子系统」核心组件
✅ 启用「虚拟机平台」虚拟化组件
✅ 下载并安装 WSL2 最新 Linux 内核
✅ 下载并安装默认的 Ubuntu Linux 发行版
✅ 自动设置 WSL2 为默认版本

2.2 创建 UNIX 用户账户

初始化完成后，按提示创建：

# 1. 输入自定义用户名（纯英文小写，无空格/中文）
Enter new UNIX username: openclaw

# 2. 输入自定义密码（输入时无字符回显，务必牢记！）
New password: 
Retype new password:

2.3 重启电脑

命令执行完成后，必须重启电脑，否则系统组件不会生效。

2.4 验证安装是否成功

wsl --list --verbose

成功标准（必须同时满足）：

STATE 列显示 Running
VERSION 列显示 2（必须为 2，不可为 1）
发行版名称显示 Ubuntu 或对应版本名

2.5 系统更新与软件源配置

# 更新软件包索引
sudo apt update

# 升级已安装的软件包
sudo apt upgrade -y

# 安装常用工具
sudo apt install -y curl wget git

第三章模块 B：自定义盘符安装 WSL2（非系统盘 D/E/F 盘）

适用场景：C 盘空间不足，想把 WSL 安装到其他盘

3.1 安装 WSL 核心组件

# 启用 WSL 核心组件
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 启用虚拟机平台组件
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 安装 WSL2 内核更新包
wsl --update

# 设置 WSL2 为默认版本
wsl --set-default-version 2

执行完成后必须重启电脑。

3.2 安装 Ubuntu 发行版

wsl --install -d Ubuntu-22.04

3.3 终止发行版（避免自动初始化）

wsl --terminate Ubuntu-22.04

3.4 在目标盘创建安装目录

示例：

导出文件临时目录：D:\WSL\backup
最终安装目录：D:\WSL\Ubuntu2204

⚠️ 关键避坑：目录路径绝对不要有中文、空格、特殊字符！

3.5 导出发行版到临时文件

wsl --export Ubuntu-22.04 D:\WSL\backup\ubuntu2204.tar

3.6 注销 C 盘的默认发行版

wsl --unregister Ubuntu-22.04

3.7 导入发行版到目标盘

wsl --import Ubuntu-22.04 D:\WSL\Ubuntu2204 D:\WSL\backup\ubuntu2204.tar --version 2

3.8 设置默认登录用户

# 进入系统
wsl -d Ubuntu-22.04

# 创建用户（替换 openclaw 为你的用户名）
useradd -m -s /bin/bash openclaw
passwd openclaw
usermod -aG sudo openclaw

# 配置 WSL 默认登录用户
echo -e "[user]\ndefault = openclaw" >> /etc/wsl.conf

# 退出
exit

3.9 重启 WSL 使配置生效

wsl --terminate Ubuntu-22.04
wsl -d Ubuntu-22.04

3.10 验证安装路径与版本

wsl --list --verbose

成功标准：

STATE 列显示 Running
VERSION 列显示 2
LOCATION 列显示你设置的目标盘路径（如 D:\WSL\Ubuntu2204）

第四章 OpenClaw 专属 WSL 环境优化配置

4.1 配置.wslconfig 文件（镜像网络模式）

在 C:\Users\<你的用户名>\.wslconfig 创建或修改文件：

[wsl2]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true
firewall=true

[experimental]
autoMemoryReclaim=gradual
hostAddressLoopback=true

应用配置：

wsl --shutdown

4.2 基础环境配置（免密设置）

sudo visudo
# 在文件末尾添加（替换 workfisher 为你的用户名）
workfisher ALL=(ALL) NOPASSWD: ALL

4.3 安装基础工具

sudo apt install -y curl wget git

4.4 安装 OpenClaw

curl -fsSL https://molt.bot/install.sh | bash

# 如果 npm 没有安装到全局环境
echo 'export PATH="/home/你的用户名/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 验证
which openclaw
openclaw --version
openclaw setup

4.5 启用 systemd（解决 gateway 启动问题）

sudo tee /etc/wsl.conf << 'EOF'
[boot]
systemd=true
EOF

# 在 Windows PowerShell 执行
wsl --shutdown

4.6 启动 OpenClaw Gateway

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

第五章新手高频问题避坑指南

问题 1：wsl --install 报错，提示需要更新内核

解决方案：手动下载安装微软官方 WSL2 内核更新包
地址：https://learn.microsoft.com/zh-cn/windows/wsl/install-manual#step-4---download-the-linux-kernel-update-package

问题 2：wsl --list --verbose 显示 VERSION 是 1，不是 2

解决方案：

wsl --set-default-version 2
wsl --set-version 你的发行版名称 2

问题 3：忘记 Ubuntu 用户密码

解决方案：

wsl -d 发行版名称 -u root
passwd 你的用户名

问题 4：镜像模式不生效，IP 还是 172 开头

解决方案：

确认.wslconfig 文件放在正确的用户目录下
执行 wsl --shutdown 完全关闭 WSL，等待 10 秒后再启动
执行 wsl --update 更新 WSL 到最新版本

问题 5：导入发行版报错，提示路径无效

解决方案：检查目标路径是否有中文、空格、特殊字符，换成纯英文路径

第六章飞书连接配置

飞书开发后台

https://open.feishu.cn/?lang=zh-CN

所需权限 scopes

（完整权限列表见原文档）

审批通过命令

openclaw pairing approve feishu EFSX8S7D

拓展链接

OpenClaw Chrome 扩展：https://chromewebstore.google.com/detail/openclaw-browser-relay/nglingapjinhecnfejdcpihlpneeadjp
OpenClaw 官方文档：https://docs.openclaw.ai

本文档持续更新，如有问题请查阅最新版本。

Windows 全场景 WSL2 + OpenClaw 运行环境完整安装教案

前置要求

硬件/软件要求

学习目标

第一章 课前必做：环境前置检查

1.1 检查 Windows 系统版本

1.2 确认 CPU 虚拟化已开启

1.3 准备管理员权限终端

第二章 模块 A：新手零门槛 一键安装 WSL2（系统盘 C 盘）

2.1 执行一键安装命令

2.2 创建 UNIX 用户账户

2.3 重启电脑

2.4 验证安装是否成功

2.5 系统更新与软件源配置

第三章 模块 B：自定义盘符安装 WSL2（非系统盘 D/E/F 盘）

3.1 安装 WSL 核心组件

3.2 安装 Ubuntu 发行版

3.3 终止发行版（避免自动初始化）

3.4 在目标盘创建安装目录

3.5 导出发行版到临时文件

3.6 注销 C 盘的默认发行版

3.7 导入发行版到目标盘

3.8 设置默认登录用户

3.9 重启 WSL 使配置生效

3.10 验证安装路径与版本

第四章 OpenClaw 专属 WSL 环境优化配置

4.1 配置.wslconfig 文件（镜像网络模式）

4.2 基础环境配置（免密设置）

4.3 安装基础工具

4.4 安装 OpenClaw

4.5 启用 systemd（解决 gateway 启动问题）

4.6 启动 OpenClaw Gateway

第五章 新手高频问题避坑指南

问题 1：wsl --install 报错，提示需要更新内核

问题 2：wsl --list --verbose 显示 VERSION 是 1，不是 2

问题 3：忘记 Ubuntu 用户密码

问题 4：镜像模式不生效，IP 还是 172 开头

问题 5：导入发行版报错，提示路径无效

第六章 飞书连接配置

飞书开发后台

所需权限 scopes

审批通过命令

拓展链接

第一章课前必做：环境前置检查

第二章模块 A：新手零门槛一键安装 WSL2（系统盘 C 盘）

第三章模块 B：自定义盘符安装 WSL2（非系统盘 D/E/F 盘）

第五章新手高频问题避坑指南

第六章飞书连接配置