> ## Content Index
> Fetch the complete content index at: https://tbbbk.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# OpenClaw Windows 安装教程（2026）：PowerShell 和 WSL2 完整指南
- URL: https://tbbbk.com/openclaw-windows-install-guide-2026/
- Published: 2026-03-08T08:23:41.000Z
- Updated: 2026-03-08T08:23:41.000Z
- Description: Windows 上装 OpenClaw 比 Linux 多踩几个坑：Node.js 版本、PowerShell 权限、C++ 编译工具都可能卡住你。这篇教程覆盖原生 Windows 安装和 WSL2 两种方式的完整步骤，附常见报错解决方案和国内镜像配置。
- Author: TuBaiBai
- Tags: OpenClaw, 折腾日记, #Import 2026-07-20 07:13

一直有人问"Windows 上怎么装 OpenClaw"，之前我写的那篇[安装教程](https://tbbbk.com/openclaw-install-host-vs-docker-debian-ubuntu/)是 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 随便哪个都行，怎么选可以看[国内使用指南](https://tbbbk.com/openclaw-china-mainland-setup-guide/)）

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

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

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

```powershell
node -v
```

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

```powershell
winget install OpenJS.NodeJS.LTS
```

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

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

```powershell
node -v
npm -v
```

两个都有输出就对了。

## 装 Git

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

```powershell
git --version
```

没有的话去 [git-scm.com](https://git-scm.com/download/win) 下载装一下，一路默认就行。装完一样要重开 PowerShell。

## 改 PowerShell 执行策略

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

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

```powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```

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

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

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

如果装 Node.js 的时候勾了自动安装工具，这步跳过。没勾的话，去装 [Visual Studio Build Tools](https://visualstudio.microsoft.com/visual-cpp-build-tools/)，安装的时候选这三个：

- "使用 C++ 的桌面开发"工作负载
- MSVC v143 编译器
- Windows 10/11 SDK

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

## 开始装 OpenClaw

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

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

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

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

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

装完跑一下：

```powershell
openclaw --version
openclaw status
```

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

## 国内用户：先换 npm 镜像

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

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

装完之后想切回去：

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

## 装好之后的配置

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

**模型 API Key**——至少得有一个。Claude 效果最好，Gemini 有免费额度，GitHub Copilot 有订阅也能用。具体怎么选看[国内使用指南](https://tbbbk.com/openclaw-china-mainland-setup-guide/)，里面写了怎么省钱。

**聊天渠道**——Telegram、Discord、飞书都行，不接也可以，直接在终端或者网页 Dashboard 聊天。要接飞书/钉钉看这篇：[飞书钉钉接入教程](https://tbbbk.com/openclaw-wechat-dingtalk-feishu-setup/)。

**启动 Gateway**——跑一下就行：

```powershell
openclaw gateway start
```

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

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

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

**spawn EINVAL**——这个是 Windows 上排名第一的报错，装插件或者跑某些操作的时候出现。原因是 Windows 调用 .cmd 文件的方式和 Linux 不一样。我专门写了一篇解决方案：[spawn EINVAL 完整修复](https://tbbbk.com/openclaw-spawn-einval-fix-windows-2026/)，四种方法从简单到彻底。

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

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

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

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

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

```powershell
$env:SHARP_IGNORE_GLOBAL_LIBVIPS=1
npm 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 里跑：

```powershell
wsl --install
```

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

进了 WSL2 之后就是 Linux 了：

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

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

## 后面看什么

装好只是开始，用起来还得看这几篇：

- [常用命令大全](https://tbbbk.com/openclaw-cli-commands-guide/)——日常操作速查
- [模型切换指南](https://tbbbk.com/openclaw-model-switch-guide/)——换模型、设默认模型
- [进阶配置](https://tbbbk.com/openclaw-advanced-config-guide/)——AGENTS.md、记忆系统、Cron 定时任务
- [安全配置](https://tbbbk.com/openclaw-security-guide-local-mac-pc/)——保护电脑不被 AI 搞坏，这篇真的要看
- [重装/卸载](https://tbbbk.com/openclaw-reinstall-clean-guide/)——装坏了想重来看这篇