你是 Windows 开发者，想要体验 OpenClaw 这个火爆的 AI Agent 框架，但安装过程中折腾了半天，Docker 容器跑不起来，WSL2 怎么都连不通外网……最后发现根本不是 OpenClaw 的问题，而是 WSL2 配置有坑。别急，本文详细记录 Windows 用户安装 OpenClaw 的所有踩坑点和解决方案，照着做，你也能 5 分钟搞定。
为什么 Windows 必须用 WSL2
很多 Windows 用户一开始不理解，OpenClaw 为什么不能直接在 Windows 上跑？简单说，OpenClaw 本质上是基于 Linux 容器环境设计的，它依赖 Docker、Python 虚拟环境等 Linux 原生工具。Windows 本身的文件系统、权限管理、进程模型跟 Linux 差异大，直接运行会导致一系列兼容性问题。
WSL2（Windows Subsystem for Linux 2）是微软官方推出的解决方案，它在 Windows 上运行一个完整的 Linux 内核，让你能够直接使用 Linux 命令和 Docker，这对于 OpenClaw 这类容器化的 AI Agent 框架是必需的。
换句话说，WSL2 就是你的”Linux 虚拟机”，OpenClaw 就跑在这个虚拟机里。
WSL2 安装前的系统检查
在正式安装 WSL2 之前，先确保你的 Windows 系统满足最低要求，这能避免很多奇怪的问题。
检查 Windows 版本
- 按
Win + R，输入winver回车，查看你的 Windows 版本 - 确保版本为 Windows 10（Build 19041+）或 Windows 11（推荐用 Windows 11）
检查硬件虚拟化是否开启
- 按
Ctrl + Shift + Esc打开任务管理器 - 点击”性能”标签页，选择”CPU”
- 确保”虚拟化：已启用”。如果显示”已禁用”，需要在 BIOS 中开启 VT-x 或 AMD-V
确保已安装 PowerShell 5.0+
- 在 PowerShell 中输入：
$PSVersionTable.PSVersion - 确保主版本号 >= 5
WSL2 完整安装步骤
这是最关键的一步，一定要按顺序来。
步骤1：以管理员身份打开 PowerShell
- 按
Win + X，选择”Windows PowerShell（管理员）” - 如果弹出 UAC 提示，点击”是”
步骤2：启用 WSL
在 PowerShell 中执行：
wsl --install -d Ubuntu-24.04
这条命令会一次性完成：启用WSL功能、安装 Ubuntu 24.04、设置 WSL2 为默认版本。整个过程需要 5-15 分钟。
步骤3：重启电脑
安装完后一定要重启，否则很多功能还没真正激活。
步骤4：验证安装成功
wsl --list --verbose
如果 VERSION 显示为 1，执行：wsl --set-version Ubuntu-24.04 2
第一个坑：版本混乱（WSL1 vs WSL2）
最常见的问题：用户装了 WSL 但一直在用 WSL1，导致 Docker 跑不了。
症状： wsl --list --verbose 看到 VERSION 是 1，或 Docker 报 “Cannot connect to Docker daemon”
解决： wsl --set-version Ubuntu-24.04 2
第二个坑：Docker Desktop 配置错误
症状： WSL 中 docker --version 显示 command not found，或 OpenClaw 启动时 Docker daemon 未响应
解决： Docker Desktop → Settings → Resources → WSL integration，勾选 Ubuntu-24.04，Apply & Restart，然后 docker run hello-world 验证。
第三个坑：WSL 网络代理配置
症状： apt update 超时，pip install 无法下载，OpenClaw 无法拉取依赖
解决： WSL 不继承 Windows 代理。先获取网关 IP：cat /etc/resolv.conf | grep nameserver，然后配置 apt 代理文件 /etc/apt/apt.conf.d/proxy.conf。
第四个坑：端口映射和防火墙
症状： OpenClaw 日志显示服务已启动，但浏览器访问 localhost:8000 无响应
解决： 编辑 ~/.wslconfig 添加 interop 配置，重启 WSL（wsl --shutdown），并在 Windows 防火墙中允许 Docker Desktop。
第五个坑：文件系统权限问题
症状： OpenClaw 报 “Permission denied”
解决： sudo chown -R $USER:$USER ~/openclaw
总结
WSL2 虽然有这些坑，但一旦配置好就非常稳定。上面覆盖了 99% 的 Windows 用户会遇到的情况。遇到问题欢迎在 xzhibot 社区分享错误日志。