OpenClaw Windows 安装教程(2026):PowerShell 和 WSL2 完整指南

一直有人问"Windows 上怎么装 OpenClaw"，之前我写的那篇是 Linux 的，Windows 确实没覆盖到。这篇就专门写 Windows，把我自己帮朋友在 Win11 上装的过程记下来。

先说体验：比 Linux 折腾。不是 OpenClaw 的锅，是 Windows 本身的环境问题——Node.js 版本、PowerShell 权限策略、C++ 编译工具，每个都可能卡你十分钟。但只要提前把这几个坑填了，后面其实很顺。

先想清楚：原生装还是 WSL2？

Windows 上装 OpenClaw 有两条路，先选好再动手，不然折腾到一半再换更痛苦。

原生 Windows（PowerShell 直接装）——不用装虚拟化，装完就在 Windows 环境里跑。如果你想让 OpenClaw 操作 Windows 桌面上的东西（比如浏览器、文件管理器），得选这个。代价是环境坑多。

WSL2（在 Windows 里跑个 Linux）——OpenClaw 官方文档也推荐这种。装完跟 Linux 一模一样，基本不踩坑。但多了一层虚拟化，而且 WSL2 默认吃 1-2GB 内存，8GB 以下的机器可能有点紧。

我帮朋友装的时候选了原生，因为他电脑只有 8GB 内存，不想再开 WSL2。下面主要写原生安装，WSL2 的方式后面也会提。

环境准备：装 OpenClaw 之前要先搞定的东西

动手之前确认一下：

Windows 10（1903 以上）或 Windows 11，64 位

至少 2GB 磁盘空间

网络能访问 npm 和 GitHub（国内用户后面讲怎么配镜像）

一个大模型的 API Key（Claude、GPT、Gemini 随便哪个都行）

装 Node.js 22（版本很重要）

OpenClaw 要求 Node.js 22 或更高，18 和 20 都不行，装错了后面会报各种奇怪的错。

先打开 PowerShell 看一下你有没有装过：

node -v

显示 v22.x.x 就跳过这步。没装或者版本太低的话，最简单是用 winget：

winget install OpenJS.NodeJS.LTS

如果你不用 winget，也可以去下载 .msi 安装包。装的时候注意看有个选项叫 "Automatically install the necessary tools"，建议勾上——它会顺便帮你装 C++ 编译工具，后面有用。

装完之后必须关掉 PowerShell 重新开。这点很重要，PowerShell 不会自动刷新 PATH，不重开就会一直报"node 不是内部或外部命令"。重开之后跑一下：

node -vnpm -v

两个都有输出就对了。

装 Git

OpenClaw 安装过程中会用到 Git，没装的话会报 spawn git ENOENT。查一下：

git --version

没有的话去下载装一下，一路默认就行。装完一样要重开 PowerShell。

改 PowerShell 执行策略

Windows 默认不让 PowerShell 跑外部脚本，OpenClaw 的安装脚本直接就会被拦住。这个很多人会卡住但不知道为什么。

右键开始菜单，选 "Windows Terminal(管理员)"，跑这个：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

提示确认就输 Y。意思是"允许本地脚本和签过名的远程脚本"，不用担心安全问题。

C++ 编译工具（可能需要装）

OpenClaw 有些依赖要编译原生模块（sharp 做图像处理、node-pty 做终端模拟），没有 C++ 编译环境就会报 node-gyp rebuild failed。

如果装 Node.js 的时候勾了自动安装工具，这步跳过。没勾的话，去装，安装的时候选这三个：

"使用 C++ 的桌面开发"工作负载

MSVC v143 编译器

Windows 10/11 SDK

安装包 2-3GB，要等一会。

开始装 OpenClaw

前面那些都搞定之后，开一个新的 PowerShell（普通权限就行），贴这个：

iwr -useb https://openclaw.ai/install.ps1 | iex

脚本会自动检测 Node 版本、用 npm 全局安装 OpenClaw、然后启动 onboarding 向导让你配 API Key 和聊天渠道。整个过程 2-5 分钟，看网速。

如果你之前已经有配置了，不想再跑向导，可以加个参数跳过：

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

装完跑一下：

openclaw --versionopenclaw status

如果报"不是内部或外部命令"，十有八九是 PATH 的问题。跑 npm config get prefix，把输出的路径加到系统环境变量的 Path 里（设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → 用户变量 Path → 新增），然后重开 PowerShell。

国内用户：先换 npm 镜像

差点忘了说这个。如果你在国内，npm 默认源慢到超时是常有的事，装之前先换成淘宝镜像：

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

装完之后想切回去：

npm config set registry https://registry.npmjs.org

装好之后的配置

Onboarding 向导会引导你配三个东西：

模型 API Key——至少得有一个。Claude 效果最好，Gemini 有免费额度，GitHub Copilot 有订阅也能用。具体怎么选看，里面写了怎么省钱。

聊天渠道——Telegram、Discord、飞书都行，不接也可以，直接在终端或者网页 Dashboard 聊天。要接飞书/钉钉看这篇：。

启动 Gateway——跑一下就行：

openclaw gateway start

然后浏览器打开 http://localhost:18789，能看到 Dashboard 就说明装好了。

Windows 上那些坑（踩过的都说痛）

帮朋友装的时候遇到的，加上 GitHub Issues 里高频出现的，整理一下：

spawn EINVAL——这个是 Windows 上排名第一的报错，装插件或者跑某些操作的时候出现。原因是 Windows 调用 .cmd 文件的方式和 Linux 不一样。我专门写了一篇解决方案：，四种方法从简单到彻底。

"openclaw 不是内部或外部命令"——PATH 没加对。跑 npm config get prefix，把输出路径加到系统 Path，重开 PowerShell。

npm ERR! code ETIMEDOUT——网络问题，换镜像源就好：

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

node-gyp rebuild failed——没装 C++ 编译工具，回上面那步装 Visual Studio Build Tools。

sharp 装不上——试试强制用预编译版本：

$env:SHARP_IGNORE_GLOBAL_LIBVIPS=1npm install -g openclaw@latest

spawn npm ENOENT——npm 或 Git 没进 PATH。确认 npm -v 和 git --version 都正常输出，不正常就重开 PowerShell。

Windows Defender 拦截——Defender 有时候会把 Node.js 的进程操作当成威胁，装到一半莫名失败就可能是它。把这几个目录加进 Defender 的排除列表就行：

%APPDATA%\openclaw

%USERPROFILE%\.openclaw

Node.js 安装目录（一般是C:\Program Files\nodejs）

路径：设置 → Windows 安全 → 病毒和威胁防护 → 管理设置 → 排除项 → 添加文件夹。装完之后排除项可以删掉。网上有些教程让你直接关 Defender，别听——加排除项就够了。

WSL2 方案：一条命令的事

如果你原生装实在搞不定，或者压根不想折腾上面这些环境问题，WSL2 确实省心很多。

管理员 PowerShell 里跑：

wsl --install

装完重启，会弹出 Ubuntu 终端让你设用户名密码。如果报错，可能要先去"启用或关闭 Windows 功能"里手动勾上"适用于 Linux 的 Windows 子系统"和"虚拟机平台"。

进了 WSL2 之后就是 Linux 了：

curl -fsSL https://openclaw.ai/install.sh | bash

一行搞定，Node.js、Git、OpenClaw 全自动装好。不会遇到 PowerShell 权限、C++ 编译工具这些 Windows 特有的坑。如果你不需要 OpenClaw 操作 Windows 桌面，WSL2 真的是更好的选择。