Windows 下基于 WSL2 与 Docker 部署 Open Claw

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 核心前置设置

1. 开启硬件虚拟化 开机进入 BIOS/UEFI，开启 Intel VT-x 或 AMD-V 虚拟化技术。这是 Docker 和 WSL2 运行的基础，否则无法启动容器。

2. 开启 Windows 必要功能 按下 Win+S 搜索「启用或关闭 Windows 功能」，勾选以下 3 个选项，点击确定后重启电脑：

   • 虚拟机平台
   • Windows 虚拟机监控程序平台
   • 适用于 Linux 的 Windows 子系统

3. 临时放行安全软件 安装前暂时关闭第三方杀毒软件（如 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：