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

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

怎么在 Windows 上装 OpenClaw?

行,今天我亲自淌一遍这个坑。手把手带你走完全程。

picture.image

先说一个大前提

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

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

第一步,装 Git

已经装了的直接跳过。

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

装完之后打开 PowerShell,敲一行

git --version 

能打印出版本号,说明没问题。打不出来就重装,别纠结。

第二步,装 WSL 和 Ubuntu

这步是整个流程的地基。

打开 PowerShell,执行

wsl --install

这条命令默认安装 WSL2 和 Ubuntu。装完之后要重启电脑。

重启之后 Ubuntu 会自动弹出来,让你设置用户名和密码。

picture.image 这里有个坑,很多人卡在这。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

验证一下

picture.image

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

打印出 v22.x.x 就没问题。

接下来启用 pnpm

corepack enable pnpm

验证

pnpm -v

有版本号输出就行。

第五步,克隆 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 服务。

picture.image

到这里就装完了

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

  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 做内网穿透。

好了,就这些。

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

0
0
0
0
评论
未登录
暂无评论