Windows 下安装 OpenClaw 环境准备完整教程
最近我在 Windows 上安装 OpenClaw 踩了不少坑，特别是环境准备这块，官网推荐安装 WSL（Windows 子系统 Linux），但我在 Win10 上遇到了各种问题，安装一直不成功。折腾了很久，终于找到了不需要 WSL 的安装方法，整理出来分享给大家。
一、前提：安装 Node.js 和 Git
首先需要安装 Node.js 22.16+ 和 Git 最新版本，这两个是必须的：
1. 安装 Node.js 22.16+
方法一：官方安装包（推荐新手）
- 访问下载地址：https://nodejs.org/dist/latest-v22.x/
- 下载文件名类似 node-v22.16.0-x64.msi 的 64位安装包（约30MB）
- 双击运行安装程序，一路点击「Next」即可，默认配置已经自动帮你添加到环境变量 Path
- 安装完成后，按 Win+R 输入 cmd 打开命令提示符，验证安装：
node -v
应该输出版本号 v22.16.0 或更高版本
npm -v
应该输出 10.x 或更高版本
方法二：使用 nvm 版本管理器（推荐开发者）
如果你需要经常切换 Node.js 版本，推荐使用 nvm：
- 下载 nvm-windows：https://github.com/coreybutler/nvm-windows/releases
- 下载 nvm-setup.exe 运行安装
- 安装完成后执行：
nvm install 22.16.0
nvm use 22.16.0
2. 安装 Git 最新版本
方法一：官方安装包（推荐）
- 官网下载：https://git-scm.com/download/win
- 浏览器会自动下载最新版本的 64位安装包
- 运行安装包，建议勾选 Add a Git Bash profile to the context menu（这样右键点击文件夹就能直接打开 Git Bash，很方便）
- Path 环境变量：选择默认的 Git from the command line and also from 3rd-party software
- 其他选项保持默认即可，一路点击「Next」完成安装
- 重新打开 cmd 验证：
git –version
输出 git version 2.xx.x 就是安装成功
方法二：winget 一键安装（Windows 10/11 推荐）
如果你用的是 Windows 10 1709+ 或 Windows 11，可以直接用系统自带的 winget 一键安装：
winget install Git.Git
winget install OpenJS.NodeJS.LTS
安装完重启终端就可以验证版本了。
👉 加速 npm 下载（可选但推荐）
国内npm默认源下载速度比较慢，可以切换到淘宝镜像加速：
npm config set registry https://registry.npmmirror.com
二、关于 WSL 的说明
OpenClaw 官网默认推荐安装 WSL（Windows 子系统 Linux），提供了一键安装脚本：
iwr –useb https://openclaw.ai/install.ps1 | iex
这个脚本会自动检测环境并帮你安装 Node.js 和 Git，确实很省心。但实际使用中我遇到了这些问题：
- 安装 Git 过程可能很慢，容易闪退
- WSL 在部分 Win10 系统上会遇到各种兼容性问题，我折腾了很久都没安装成功
如果你能顺利装上 WSL，那直接用官网脚本最方便。如果你和我一样，WSL 安装一直出问题，接着往下看，这有不用 WSL 的替代方案。
三、无需 WSL：通过 Visual Studio 安装 C++ 开发环境
OpenClaw 需要编译一些 Node.js 原生模块，所以必须要有 C++ 编译环境。不用 WSL 也能搞定，直接安装 Visual Studio 的 C++ 桌面开发组件即可。
1. 下载 Visual Studio
- 打开官网下载：https://visualstudio.microsoft.com/zh-hans/downloads/
- 下载免费的 Community 社区版 就够用了，不需要付费
2. 选择安装组件
运行安装程序后，一定要勾选「使用C++的桌面开发」 这个工作负载：
3. 等待安装完成
选择好组件后点击安装，等待下载和安装完成。这个过程需要下载几个GB的文件，时间长短取决于你的网速：
安装完成后，你的 Windows 就拥有了完整的 MSVC 编译工具链，可以正常编译 Node.js 原生模块了。
四、下一步
环境准备完成后：
总结
| WSL + 一键脚本 | 省心省力，环境纯净 | 能顺利装上WSL的同学 |
| VS C++ 组件 | 无需WSL，原生Windows运行 | WSL安装失败的同学 |
不管用哪种方案，都必须保证：
- Node.js 版本 ≥ 22.16.0
- Git 使用最新版本
希望这篇教程能帮到同样在 Windows 上安装 OpenClaw 踩坑的朋友，少走点弯路。如果你安装成功了，欢迎在评论区留言交流。
如果你觉得这篇文章有用，别忘了点个赞👍
