Windows 部署（WSL2）：安装 OpenClaw、与桌面环境协作、常见坑位

本章目标：在 Windows 上用 WSL2（Ubuntu）稳定运行 OpenClaw，并清楚什么时候需要把 Gateway 放在“有桌面环境的机器”。

1) 为什么 Windows 推荐 WSL2

• OpenClaw 的核心运行环境偏 Linux/Node 生态

• WSL2 能提供一致的依赖与脚本环境

• 一些工具（如浏览器控制、系统依赖）在纯 Windows 环境下更容易踩坑

结论：Windows + WSL2 是最少折腾的方案。

2) 安装 WSL2 + Ubuntu

按微软官方方式安装 WSL2 与 Ubuntu（略）。

进入 WSL2 后建议先更新：

sudo apt update && sudo apt -y upgrade

3) 安装 Node.js（建议 ≥ 22）

推荐用 nvm 管理 Node：

# 安装 nvm（按官方方式）
# 安装 Node 22+
nvm install 22
nvm use 22
node -v

4) 安装 OpenClaw 并初始化

npm install -g openclaw@latest
openclaw onboard --install-daemon

如果暂时不接 IM 渠道：

openclaw onboard --skip-channels --install-daemon

5) 与桌面环境协作（关键点）

5.1 浏览器控制（Browser tool）的现实约束

• 如果你要做：自动登录、操作 JS 重站、截图/提取 DOM

• 通常更稳定的方式是：Gateway 跑在有 GUI 的机器（你的 Windows 桌面 / mac / Linux 桌面）

当 Gateway 跑在 WSL2（无 GUI）但你仍要浏览器控制：

• 使用“桌面机运行 browser proxy / relay”的模式

• 让 WSL2 的 Gateway 把动作代理到桌面端浏览器

（具体命令与配置以 OpenClaw 当前版本文档为准，本章给落地原则与坑位。）

5.2 文件系统与性能

建议把 workspace 放在 Linux 文件系统（WSL 的 home）下：

• ✅ /home/<user>/.openclaw/workspace（快、权限一致）

• ⚠️ /mnt/c/...（跨文件系统可能慢、权限/换行符坑多）

6) 最小可用验证

openclaw agent --message "写一个 Python 的重试装饰器" --thinking high

7) 常见坑位

7.1 端口访问与防火墙

• WSL2 端口转发与 Windows 防火墙策略可能影响 Web UI 或 webhook 回调

• 如果你要接飞书/外网回调，不建议直接暴露到公网；优先用内网穿透并加签名校验/allowlist

7.2 环境变量在 daemon 中不可见

• 交互 shell 设置的 export XXX=... 未必会被后台服务继承

• 优先用 OpenClaw 配置系统持久化 provider key

---

返回目录