每天私信问我同一个问题的人，少说十个。

怎么在 Windows 上装 OpenClaw？

行，今天我亲自淌一遍这个坑。手把手带你走完全程。
![OpenClaw](https://developer.qcloudimg.com/http-save/yehe-5421023/7709a0242e2cc2c2eec58bb0d0bf5f81.png)
## 先说一个大前提

OpenClaw 这玩意儿，在 Windows 上的原生兼容性，说难听点，基本没法用。官方明确建议 Windows 用户通过 WSL 来安装，原生 PowerShell 安装虽然能跑，但开发者自己都不推荐，因为不稳定。

![image.png](https://developer.qcloudimg.com/http-save/yehe-5421023/afb8092a5163ee5ef9d6edfc70acf282.png)

所以别想着直接在 PowerShell 里 npm install 一把梭了。老老实实走 WSL 路线，这是唯一靠谱的方案。

## 第一步，装 Git

已经装了的直接跳过。

没装的去 https://git-scm.com/downloads ，选 Windows，一路下一步就完事。

装完之后打开 PowerShell，敲一行

```
git --version 
```
![image.png](https://developer.qcloudimg.com/http-save/yehe-5421023/5c33d89f1d0a15d0165512d3247c98e3.png)
能打印出版本号，说明没问题。打不出来就重装，别纠结。

## 第二步，装 WSL 和 Ubuntu

这步是整个流程的地基。

打开 PowerShell，执行

```
wsl --install
```
![image.png](https://developer.qcloudimg.com/http-save/yehe-5421023/1b736d3388f5ebda7fee70e1bc7f68af.png)
这条命令默认安装 WSL2 和 Ubuntu。装完之后要重启电脑。

重启之后 Ubuntu 会自动弹出来，让你设置用户名和密码。
![image.png](https://developer.qcloudimg.com/http-save/yehe-5421023/3236b19b535deb91f486cb02243de6f6.png)
这里有个坑，很多人卡在这。Linux 下输密码是没有任何显示的，你打的每一个字符都看不见。别以为键盘坏了，闭眼盲打就行，打完回车确认。

## 第三步，开启 systemd

这步很多教程不提，但必须做。OpenClaw 的 Gateway 是作为 systemd 服务来运行的，所以 WSL 里必须把 systemd 打开。

在 Ubuntu 终端里粘贴执行

```
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
```

然后注意了，要切回 PowerShell

```
wsl --shutdown
```

把 WSL 关掉。再重新打开

```
wsl
```

验证一下
![image.png](https://developer.qcloudimg.com/http-save/yehe-5421023/3300dadbb37d78778c826ca12c39a2f8.png)
```
systemctl --user status
```

能正常输出状态信息就对了。如果报错，说明上一步配置没写进去，回去再来一遍。

## 第四步，装 Node 环境

OpenClaw 要求 Node 版本不低于 22。这个版本要求卡死了，装低了跑不起来。

原文用的是 nvm v0.40.3 来安装，这个版本没问题可以用。不过提醒一句，nvm 目前最新版已经到了 v0.40.4。建议大家直接用最新的

```
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
```

装完加载一下

```
\. "$HOME/.nvm/nvm.sh"
```

然后装 Node

```
nvm install 22
```

这里我要纠正原文一个问题。原文写的是 nvm install 24，但 Node 24 目前还在开发阶段，不是稳定版。官方文档和各种安装指南里写的都是 Node 22，这也是 OpenClaw 的最低要求版本。用 22 就够了，稳定可靠，别追新。

验证一下

```
node -v
```
![image.png](https://developer.qcloudimg.com/http-save/yehe-5421023/e903554035950d136a0816334e1dfb72.png)
打印出 v22.x.x 就没问题。

接下来启用 pnpm

```
corepack enable pnpm
```

验证

```
pnpm -v
```
![image.png](https://developer.qcloudimg.com/http-save/yehe-5421023/aae55466b357b7d5d0368d11d2b399ef.png)
有版本号输出就行。

## 第五步，克隆 OpenClaw 仓库

建议别装 C 盘。在 WSL 里切到 D 盘

```
cd /mnt/d
```

然后克隆

```
git clone https://github.com/openclaw/openclaw.git
```

这一步取决于你的网速。项目确实不小，慢的话可能半小时甚至更久。国内用户如果 GitHub 拉不动，自己想办法解决网络问题，这里不展开。

**安全提醒插一嘴。** 一定要认准官方仓库地址 github.com/openclaw/openclaw。之前有人在搜索引擎上投放假的安装程序，实际上是恶意软件。别从任何奇怪的地方下载所谓的安装包。

克隆完之后，D 盘会多出一个 openclaw 目录。

## 第六步，安装依赖

进入目录

```
cd openclaw/
pnpm i
```

依赖也不少，耐心等。中途可能会看起来卡住了，别慌别关，安装完会有明确的提示。

原文说可能要 30 分钟到 1 小时。说实话这个时间因人而异，网速快的十几分钟也能搞定，网速慢的确实得等。

然后这里有一个关键的区别。原文用的是 git clone 之后 pnpm i 再 pnpm openclaw onboard 这种从源码构建的方式。实际上 OpenClaw 有两种安装方式，一种是通过 npm 全局安装发布包，一种是从 GitHub 克隆源码。如果你只是想用，npm install -g openclaw 是最快的路径。

但如果你想折腾源码，按原文的方式走也完全可以。只是要注意，克隆后还需要额外执行 pnpm ui:build 来构建 UI。原文漏掉了这个步骤。

## 第七步，启动 onboard 向导

```
pnpm openclaw onboard
```

到这一步，你会看到交互式的配置界面。onboard 向导会引导你配置 bot、身份验证和 Gateway。

跟着提示走就行，选你要接入的消息平台，配置 API Key，设置 Gateway 服务。
![image.png](https://developer.qcloudimg.com/http-save/yehe-5421023/2f65316159057824557cad114565c121.png)
## 到这里就装完了

回顾一下整个流程，说白了就是四件事

1. 装 WSL，让 Windows 能跑 Linux
2. 在 WSL 里把 Node 环境搭好
3. 拉代码装依赖
4. 跑 onboard 配置

核心思路就这么简单。

## 几个容易踩的坑，提前说

WSL 内存占用可能很高。WSL2 会比较贪吃内存，建议在用户目录下创建 .wslconfig 文件来限制内存上限。

如果装完之后执行 openclaw 命令提示找不到，大概率是 npm 全局 bin 路径没加到 PATH 里。手动加一下就好。

如果你要用浏览器相关的 Skill，比如 Playwright 或 Puppeteer MCP，需要先在 WSL 里装 Chrome。这个原文没提，但你迟早会遇到。

最后，Gateway 不要直接暴露在公网上。2026 年 1 月曾爆出多个严重安全漏洞，建议用 Tailscale 做内网穿透。

好了，就这些。

别再私信问我了，转发这篇文章就行。

OpenClaw 这玩意儿，在 Windows 上的原生兼容性，说难听点，基本没法用。官方明确建议 Windows 用户通过 WSL 来安装，原生 PowerShell 安装虽然能跑，但开发者自己都不推荐，因为不稳定。

不用VPS！纯Windows安装OpenClaw，RTX显卡直驱本地AI Agent

产品KOL

人工智能

客户端

开发工具

"Windows安装OpenClaw详细教程：通过WSL2+Ubuntu+Node22环境部署OpenClaw，解决原生兼容性问题。包含Git安装、WSL配置、systemd启用、Node环境搭建、源码克隆等完整步骤，特别提醒注意内存限制、安全配置等常见问题，提供两种安装方式选择。"

身份验证

Windows

GitHub

Ubuntu

Linux

人脸核身+人脸识别特惠活动0.6折起


faceid

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

不用VPS！纯Windows安装OpenClaw，RTX显卡直驱本地AI Agent-腾讯云开发者社区-腾讯云

不用VPS！纯Windows安装OpenClaw，RTX显卡直驱本地AI Agent

不用VPS！纯Windows安装OpenClaw，RTX显卡直驱本地AI Agent

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐