OpenClaw Windows 本地部署完整教程：WSL2 + Ubuntu 环境搭建

2026-06-01 AI-Pick - 精选AI工具导航已浏览9次

OpenClaw 是一个开源自托管的 AI Agent 框架，可以运行在你的电脑或服务器上。在 Windows 上部署 OpenClaw，最推荐的方式是使用 WSL2（Windows Subsystem for Linux 2）——它在 Windows 中运行一个完整的 Linux 内核，性能和兼容性都远优于直接在 Windows 原生环境运行。

本教程将从零开始，带你完成 Windows 本地部署 OpenClaw 的全部流程。

一、环境要求

项目	要求
操作系统	Windows 10 版本 2004+ / Windows 11
权限	管理员权限（部分步骤需要）
内存	建议 16GB（Windows + WSL2 共享）
磁盘	至少 10GB 可用空间
网络	稳定的互联网连接

二、安装 WSL2

2.1 一键安装

以管理员身份打开 PowerShell，执行以下命令：

wsl --install

这个命令会自动完成三件事：

启用 WSL 功能
安装 WSL2 内核
安装默认的 Ubuntu 发行版

安装完成后需要重启电脑。

2.2 初始化 Ubuntu

重启后，Ubuntu 会自动启动，并要求你：

创建 Linux 用户名和密码（和 Windows 用户名无关）
等待初始化完成

2.3 确认 WSL 版本

在 PowerShell 中执行：

wsl --list --verbose

确保 VERSION 列显示为 2。如果显示的是 1，需要手动升级：

wsl --set-version Ubuntu 2

三、启用 systemd

OpenClaw 的守护进程依赖 systemd 来管理服务生命周期，WSL2 默认没有启用 systemd，需要手动配置。

3.1 编辑 WSL 配置

在 WSL Ubuntu 终端中执行：

sudo nano /etc/wsl.conf

添加以下内容：

[boot]
systemd=true

保存（Ctrl+O → Enter → Ctrl+X）。

3.2 重启 WSL

在 PowerShell 中执行：

wsl --shutdown

然后重新打开 Ubuntu 终端，验证 systemd 是否生效：

systemctl --version

四、在 WSL2 中安装 OpenClaw

4.1 更新系统包

sudo apt update && sudo apt upgrade -y

4.2 安装 Node.js 22

OpenClaw 官方推荐 Node.js 22.x 或更高版本：

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 验证
node --version
npm --version

国内加速：如果 npm 安装慢，建议配置国内镜像：

npm config set registry https://registry.npmmirror.com

4.3 安装 OpenClaw

npm install -g openclaw

# 验证安装
openclaw --version

4.4 初始化配置

运行交互式引导配置：

openclaw onboard

引导过程会：

选择 AI 模型提供者（如 Claude、GPT、Qwen、MiniMax 等）
配置 API Key
生成配置文件到 ~/.config/openclaw/openclaw.json5

五、启动网关

5.1 安装网关守护进程

openclaw onboard daemon

此命令会创建 systemd 用户级服务并配置自动启动。

5.2 手动启动网关（快速测试）

openclaw gateway start

5.3 检查运行状态

openclaw gateway status

5.4 访问 Web 控制面板

默认情况下，网关监听在 localhost:3000。WSL2 会自动将 localhost 映射到 Windows 主机，所以直接在 Windows 浏览器中访问：

http://localhost:3000

六、局域网访问（可选）

如果你希望从同一局域网的其他设备（手机、平板）访问 OpenClaw，需要进行端口转发配置。

6.1 获取 WSL2 的 IP 地址

wsl hostname -I

6.2 设置端口转发

以管理员身份在 PowerShell 中执行：

netsh interface portproxy add v4tov4
  listenport=3000
  listenaddress=0.0.0.0
  connectport=3000
  connectaddress=(wsl hostname -I).Trim().Split(' ')[0]

6.3 配置防火墙

New-NetFirewallRule -DisplayName "OpenClaw Gateway" `
  -Direction Inbound `
  -Protocol TCP `
  -LocalPort 3000 `
  -Action Allow

6.4 自动刷新转发规则脚本

WSL2 每次重启后 IP 地址可能会变化，建议创建一个 PowerShell 脚本 refresh-wsl-proxy.ps1：

$wslIp = (wsl hostname -I).Trim().Split(' ')[0]
netsh interface portproxy delete v4tov4 listenport=3000 listenaddress=0.0.0.0
netsh interface portproxy add v4tov4 `
  listenport=3000 `
  listenaddress=0.0.0.0 `
  connectport=3000 `
  connectaddress=$wslIp
Write-Host "WSL IP: $wslIp, 端口转发已更新"

每次 Windows 重启后，以管理员身份运行此脚本即可。

七、Windows 专项优化

7.1 IPv4 绑定（v2026.5.4+ 自动修复）

在 Windows 上运行 OpenClaw 时，底层 libuv 库对双栈 IPv6 的支持存在问题，可能导致 localhost 请求卡死。从 v2026.5.4 版本开始，OpenClaw 在 Windows 上默认配置网关仅绑定 IPv4 地址。

验证绑定地址：

netstat -an | findstr :3000

期望输出 TCP 127.0.0.1:3000，而不是 [::1]:3000。

7.2 防火墙配置

# 允许私有网络访问
New-NetFirewallRule -DisplayName "OpenClaw Gateway"
  -Direction Inbound -Protocol TCP -LocalPort 3000
  -Action Allow -Profile Private

# 阻止公网访问
New-NetFirewallRule -DisplayName "OpenClaw Block Public"
  -Direction Inbound -Protocol TCP -LocalPort 3000
  -Action Block -Profile Public

7.3 Windows Defender 排除

为避免杀毒软件误拦截，将 OpenClaw 目录加入白名单：

Add-MpPreference -ExclusionPath "$env:APPDATAopenclaw"
Add-MpPreference -ExclusionProcess "node.exe"

八、性能优化建议

8.1 在 Linux 文件系统下运行

WSL2 中，Linux 文件系统（/home/）的 I/O 性能远优于挂载的 Windows 路径（/mnt/c/）。确保 OpenClaw 的配置文件和工作目录在 /home/ 下。

8.2 优化 Node.js 内存

openclaw config set runtime.node.maxOldSpaceSize 4096

8.3 启动编译缓存

参考云服务器部分的 NODE_COMPILE_CACHE 配置，同样适用于 WSL2，可以加快每次启动速度。

8.4 磁盘空间优化

WSL2 默认使用 VHD 虚拟硬盘，可以通过以下命令启用稀疏文件模式来优化磁盘占用：

wsl --manage Ubuntu --set-sparse true

九、常见问题

Q1：WSL 终端关闭后 OpenClaw 还能运行吗？

如果通过 openclaw onboard daemon 安装了 systemd 服务，关闭终端后服务仍在运行。WSL 实例可能会在闲置后自动关闭，可以通过设置 wsl.conf 中的 [interop] 选项防止。

Q2：WSL2 中 OpenClaw 性能如何？

WSL2 运行的是真正的 Linux 内核，性能接近原生 Linux。日常使用完全无感。

Q3：是否可以在 Windows 原生环境运行？

不推荐。OpenClaw 的许多功能依赖 Linux 特性。WSL2 是 Windows 用户的最佳实践方案。

Q4：如何更新 OpenClaw？

npm update -g openclaw
openclaw gateway restart

Q5：端口被占用怎么办？

# 查看占用 3000 端口的进程
netstat -ano | findstr :3000

# 或者修改 OpenClaw 端口
openclaw config set gateway.port 18789

总结

通过 WSL2 + Ubuntu 部署 OpenClaw，你可以在 Windows 电脑上获得接近 Linux 原生性能的 AI Agent 运行环境。

整个流程的核心步骤：

安装 WSL2 + Ubuntu
启用 systemd
安装 Node.js 22 + OpenClaw
运行 openclaw onboard 初始化
启动网关 openclaw gateway start
浏览器访问 http://localhost:3000

部署完成后，你可以在本地运行一个完整的 AI Agent，连接各种聊天平台，安装技能插件，实现邮件管理、日程安排、智能家居控制等多种自动化场景。

相关资源：

OpenClaw 中文社区：https://openclaw.cn
官方文档：https://docs.openclaw.ai
技能市场：https://clawhub.ai
GitHub：https://github.com/openclaw/openclaw

→ 访问 OpenClaw 中文社区 → 收藏 AI Pick 导航站