我的Windows部署OpenClaw实操:—完整踩坑记录
目标很简单：在 Windows 上通过 WSL2 本地部署 OpenClaw。实现通过微信对接OpenClaw，体验通过微信操作本地PC来办公。
整个过程踩了无数坑。如果你也想在 Windows 上玩 OpenClaw，这篇能帮你省下 80% 的时间。
一、先搞清楚：OpenClaw 是什么？
OpenClaw 是一个开源的 AI Agent 平台，相当于你自己本地跑一个 “Cursor / Claude Code”，但更灵活——可以通过微信、Telegram、飞书等消息通道跟它交互，内置 49 个技能，能做浏览器自动化、文件管理、代码、搜索等等。
我的操作是：Windows 11 桌面 + WSL2 + Ubuntu 24.04 + Node.js 24 + OpenClaw，全程本地，不依赖云服务。
二、WSL2 部署：看起来简单，实际踩了 6 个坑
操作系统：Windows 11 家庭版 中文版，64为操作系统。
→ npm install -g openclaw
WSL 官方镜像托管在 Azure blob storage，国内直连下载速度只有 22 KB/s。一个 373MB 的 Ubuntu 镜像和 16MB 的内核 MSI，理论上一小时能搞定的下载，实际跑了快半天。
解决方案：用 ghproxy.net 代理 GitHub 下载，速度直接从 23KB/s 跳到 3MB/s，快了 130 倍。
https://github.com/microsoft/WSL/releases/download/2.7.3/wsl.2.7.3.0.x64.msi
https://ghproxy.net/https://github.com/microsoft/WSL/releases/download/2.7.3/wsl.2.7.3.0.x64.msi
写了安装脚本 `install-wsl2.ps1`，一跑就报错：
无法加载文件 .\install-wsl2.ps1，因为在此系统上禁止运行脚本。
解决方案：不需要改系统策略，直接用 Bypass 参数：
powershell -ExecutionPolicy Bypass -File “C:\Users\river\WorkBuddy\Claw\install-wsl2.ps1”
踩坑 ③：System32 的 wsl.exe 是个”壳”
DISM 启用 WSL 功能后，`wsl.exe` 存在但只是一个 stub（v10.0.26100），它不会真正工作，只会提示你去 Microsoft Store 下载完整版。
真正的 WSL 引擎装在 `C:\Program Files\WSL\` 目录下，包含 `wsl.exe`、`wslservice.exe` 等完整组件。
“C:\Program Files\WSL\wsl.exe”–import Ubuntu-2404 C:\Ubuntu “镜像文件路径”
或者把 `C:\Program Files\WSL` 加入 PATH：
setx PATH “%PATH%;C:\Program Files\WSL”
这是最隐蔽的一个。DISM 命令显示 `操作成功完成`，但 `wsl –import` 报错：
HCS_E_SERVICE_NOT_AVAILABLE
根本原因：DISM 启用的 WSL 和虚拟机平台功能要在重启电脑后才会注册 LxssManager 和 HCS 服务。不重启就是不行，没有任何 workaround。
`wsl –install –no-distribution` 会从 Microsoft Store CDN 在线下载，速度慢且不稳定。既然我们手头有离线 MSI 安装包，直接用：
msiexec /i “wsl_engine.msi”/quiet /norestart
踩坑 ⑥：npm 直连 registry.npmjs.org 极慢
在 WSL Ubuntu 里跑 `npm install -g openclaw`，直连官方源几乎卡死。
解决方案：配置淘宝镜像（npmmirror），483 个依赖包 32 秒搞定：
npmconfigsetregistryhttps://registry.npmmirror.com
npminstall-gopenclaw
到这里，基础的设施才算安装完成。总结下来，主要问题就是国内直接下载网速太慢，采用镜像加速下载。
现在可以直接运行 `openclaw onboard` ，运行后后会进入交互式向导，几个关键选择：
步骤 Setup mode：默认为QuickStart模式
步骤 Model ：默认 gpt-5.5，可以用 DeepSeek / 豆包等国产模型
步骤 SearchProvider： 国内选 Moonshot/Kimi，免费额度，不需要科学上网
步骤 Install skill dependencies：我选了github
六 绑定微信操作，能从微信控制OpenClaw操作电脑
这就是OpenClaw安装全过程，以及打通微信对接流程。
夜雨聆风
