通过 WSL2 在 Windows 上部署 OpenClaw 完整指南

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

适用于 Windows ¹⁰⁄₁₁，在 WSL2 环境中完美运行 OpenClaw

为什么选 WSL2
环境准备
安装 WSL2
配置 Linux 环境
安装 OpenClaw
配置与验证
Windows 与 WSL2 互操作
常见问题解决
生产环境建议
总结

WSL2（Windows Subsystem for Linux 2） 是微软官方提供的 Linux 兼容层，它运行真实的 Linux 内核，性能接近原生。

WSL2 vs 其他方案对比

方案优点缺点推荐度 WSL2 性能好、兼容性强、Linux 原生环境需要开启 Hyper-V ⭐⭐⭐⭐⭐ Docker Desktop (WSL2 后端) 容器化、易管理资源占用较大 ⭐⭐⭐⭐ Cygwin/MSYS2 轻量、无需虚拟机兼容性差，很多 Linux 工具不支持 ⭐⭐ 虚拟机 (VirtualBox/VMware) 完全隔离性能差、文件共享麻烦 ⭐⭐ 原生 Windows 简单很多 Linux-only 的工具跑不了 ⭐

为什么 OpenClaw 需要 WSL2

OpenClaw 的核心设计基于 Unix/Linux 哲学：

依赖大量 Linux 工具链
- Shell 脚本（.sh）
- 进程管理（systemd, Supervisor）
- 文件权限和符号链接
- 管道和重定向
Agent Workspace 隔离
- 每个 Agent 有独立的目录
- 需要 Linux 的文件权限控制
- 符号链接支持（用于 Skill 挂载）
Gateway 的后端进程管理
- 基于或的服务管理
- 日志文件输出到
- 端口监听和防火墙配置
第三方 Skill 兼容性
- 很多 Skill 是用 Python/bash 写的，假设运行在 Linux 环境
- Nginx/Node.js 前端构建依赖 Linux 工具链

结论：想在 Windows 上跑 OpenClaw，WSL2 是**选择。

系统要求

Windows 10 2004+ 或 Windows 11
至少 4GB RAM（推荐 8GB）
至少 10GB 磁盘空间
处理器支持 虚拟化（Intel VT-x 或 AMD-V）

检查虚拟化是否开启

查看：

如果没有，需要进 BIOS 开启虚拟化（Intel 处理器开 VT-x，AMD 开 SVM）。

第一步：一键安装（最简单）

以管理员身份打开 PowerShell，运行：

这会：

安装 WSL2 所需的所有 Windows 组件
安装默认的 Linux 发行版（Ubuntu）
设置 WSL2 为默认版本
重启电脑

重启后，系统会自动启动 Ubuntu 安装过程，让你设置用户名和密码。

第二步：手动安装（如果需要特定发行版）

如果不可用或你想用其他发行版：

第三步：验证 WSL2

VERSION 必须是 2，如果是 1 需要升级：

首次启动 Ubuntu 后，会打开一个终端窗口。

1. 更新包管理器

2. 安装基础工具

3. 配置 Docker（可选但推荐）

然后重新打开 Ubuntu 终端，测试：

4. 配置时区

5. 优化磁盘空间（可选）

WSL2 默认磁盘空间无限增长，可以设置限制：

编辑：

添加：

方式一：npm 全局安装（推荐）

方式二：源码安装（开发者）

1. 初始化 OpenClaw 配置

2. 启动 Gateway

3. 验证安装

4. 测试 Web 界面

从 Windows 浏览器访问：

如果看到 OpenClaw 的欢迎页面，说明成功了。

1. 文件系统互访

从 Windows 访问 Linux 文件：

例如，我的 WSL Ubuntu 用户名是：

从 Linux 访问 Windows 文件：

重要提示：

在下运行 Linux 程序性能较差，因为涉及文件系统转换
建议把代码和运行数据放在 Linux 侧（目录）
只有需要和 Windows 程序（如 VS Code）交互时才访问

2. 端口转发

WSL2 有自己的虚拟网卡，但 Windows 可以自动转发端口。

WSL2 里启动的服务，Windows 可以直接访问：

如果需要从局域网其他设备访问 WSL2：

WSL2 的 IP 会变，需要在 Windows PowerShell 里设置端口代理：

3. 使用 VS Code 开发

安装 Remote - WSL 插件：

在 VS Code 安装 “Remote - WSL” 扩展
按，输入 “WSL: Connect to WSL”
选择 Ubuntu
直接在 VS Code 里打开 Linux 文件系统

工作流：

代码写在 Linux 侧（）
VS Code 通过 WSL 插件远程编辑
终端直接用 VS Code 的集成终端（已连接到 WSL）
Git 在 Linux 环境运行

4. 剪贴板共享

WSL2 和 Windows 剪贴板是互通的：

❌ 问题 1：报错 “0xe”

原因：WSL 服务未启用。

解决：

❌ 问题 2：WSL2 里命令找不到

原因：npm 全局安装路径不在中。

解决：

❌ 问题 3：Docker 无法在 WSL2 启动

错误：

原因：Docker 服务没启动，或用户不在 docker 组。

解决：

❌ 问题 4：端口 7890 被占用

❌ 问题 5：Windows 浏览器无法访问 WSL2 服务

检查：

WSL2 里的服务确实在运行：
Windows 防火墙没拦截：
WSL2 的 IP 是否正确：（应该和里显示的 WSL 网卡 IP 一致）

临时方案：用不行时，用 WSL2 的 IP 访问：

❌ 问题 6：文件权限问题

现象：或

解决：

❌ 问题 7：WSL2 磁盘空间不足

默认 WSL2 虚拟硬盘大小是 ~1TB（动态扩展），但实际占用多少才用多少。

查看当前使用：

清理缓存：

缩小 WSL2 虚拟硬盘（需要关闭所有 WSL 实例）：

1. 使用 systemd 管理服务

WSL2 默认不启动 systemd，但可以开启。

方法：安装（systemd 的 WSL2 适配器）

2. 配置自动启动

编辑：

3. 备份配置

定期备份：

4. 日志管理

OpenClaw 日志默认在。

配置 logrotate：

内容：

5. 使用 Docker Compose 部署完整栈

如果你要部署 Edict 这类需要多服务的项目，用：

启动：

WSL2 部署清单

✅ Step 1：一键安装 WSL2 + Ubuntu
✅ Step 2：更新系统
✅ Step 3：安装 Node.js 和 OpenClaw CLI：
✅ Step 4：初始化配置：
✅ Step 5：启动 Gateway：
✅ Step 6：Windows 浏览器访问验证