Windows 下基于 WSL2 与 Docker 部署 Open Claw
一、前置准备(所有方案必看)
1. 系统与硬件要求
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| 系统版本 | Windows 11 22H2 及以上 64 位 | Windows 11 23H2 最新稳定版 |
| CPU | x86-64 双核 2.0GHz | 四核 2.5GHz+,支持硬件虚拟化 |
| 内存 | 4GB | 8GB+(Docker / 多技能运行需充足内存) |
| 磁盘 | 1GB 可用空间 | 10GB+ SSD(存放镜像、依赖与数据) |
| 网络 | 稳定外网连接(可访问 GitHub/npm) | 带国内镜像加速的网络 |
2. Windows 11 核心前置设置
-
开启硬件虚拟化 开机进入 BIOS/UEFI,开启
Intel VT-x或AMD-V虚拟化技术。这是 Docker 和 WSL2 运行的基础,否则无法启动容器。 -
开启 Windows 必要功能 按下
Win+S搜索「启用或关闭 Windows 功能」,勾选以下 3 个选项,点击确定后重启电脑:- 虚拟机平台
- Windows 虚拟机监控程序平台
- 适用于 Linux 的 Windows 子系统
-
临时放行安全软件 安装前暂时关闭第三方杀毒软件(如 360、腾讯电脑管家)和 Windows Defender 实时防护,避免拦截脚本执行、端口监听和依赖下载。安装完成后可重新开启。
二、方案:官方推荐 WSL2+Docker 部署(兼容性最强,优先选择)
该方案通过 WSL2 提供原生 Linux 环境,配合 Docker 容器化技术,能最大程度保证依赖隔离与跨平台一致性。相比直接安装,这种方式在 Windows 上对开发工具链的支持更友好,且资源占用相对可控。
1. 安装与更新 WSL
打开 PowerShell(管理员模式),执行以下命令安装默认发行版:
wsl --install
若已安装,建议先更新内核至最新版:
wsl --update
首次启动会自动提示设置用户名和密码,按提示操作即可。进入 Ubuntu 终端后,建议先更新源:
sudo apt update && sudo apt upgrade -y
2. 安装 Docker Engine
在 WSL2 内部安装 Docker 引擎比使用 Docker Desktop 更轻量,适合纯后端服务部署。参考官方文档安装脚本:
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
安装完成后,将当前用户加入 docker 组,免输 sudo:


