2026年手把手教你 Win11 + WSL2 装 OpenClaw：从环境配置到成功运行

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

 <svg xmlns="http://www.w3.org/2000/svg" style="display: none;"> <path stroke-linecap="round" d="M5,0 0,2.5 5,5z" id="raphael-marker-block" style="-webkit-tap-highlight-color: rgba(0, 0, 0, 0);"></path> </svg> <p></p>

在 Windows 上装 OpenClaw，本来以为“curl 一下”就搞定，结果卡在了一个意想不到的地方……如果你也打算在 Win + WSL2 上折腾这个 AI 工具，建议先看看我踩过的这些坑，能省下不少时间。

✅ Node ≥ 22（重要！）
✅ 系统：macOS / Linux / Windows + WSL2
⚠️ pnpm：只有从源码编译才需要，用安装脚本的话不用管

Windows用户记得先打开WSL。CMD里敲：

GPT plus 代充 只需 145

进入wsl

一行命令搞定（官方脚本）：

第一次跑的时候报错了（别慌，正常现象）：
![安装报错1](https://i-blog.csdnimg.cn/direct/8f26f439c2e545f3be70dbdeada61009.png)
npm版本问题

检查发现是npm版本太低，和Node 22不搭。调整版本后，同样的命令再跑一次，这次就丝滑了：

在这里插入图片描述

剩下的也是一路 YES 就完事儿了。

GPT plus 代充 只需 145

大模型我之前选择的Qwen，没配置API key我担心后面会有问题。所以执行命令重新配置一下，这回我用的QianFan（别问我为什么换了模型，问就是重新配置Qwen的也没整明白哪里能重新配置API key）。在这里插入图片描述

执行命令之后就重新配置向导，然后选择QianFan之后会给出获取API key的地址，访问创建API key就可以cv过来了。
在这里插入图片描述
然后又要挠头了，这里我决定先跳过（Skip for now）。顶多就是能看不能用，至少先不报错运行起来。
啊不对，昨天还没有Feishu呢，今天就有了，这更新速度，大写的👍👍👍！！！！果断选Feishu。（昨天尝试了下Telegram，一直收不到验证码，估计可能需要点魔法~~~）
在这里插入图片描述

安装飞书失败了，哎，先跳过，解决认证问题。后面还有好多配置，都No No No 了。然后重启，访问页面再试试。

GPT plus 代充 只需 145

我的问题来了，执行这个命令之后反复报错

1.systemd 用户服务不可用：这是根本原因。输出明确指出“WSL2 needs systemd enabled”，说明WSL2 中使用 OpenClaw，但该 Linux 发行版默认未启用 systemd。
2.服务配置非标准：由于 systemd 不可用，网关服务的 PATH 环境变量未正确设置。
3.RPC 连接失败：因为网关没有作为服务稳定运行，所以 ws://127.0.0.1:18789 这个通信端点无法连接。

这里我之前在文件中配置过，但是没重启。结果就导致一直在报错搞不定这个问题。所以大家要记住配置完要~~~~

再次执行命令

在这里插入图片描述

这里报错了，问题很明确gateway token missing，按照提示的命令操作拿到token在概览里面配置一下就好了。
在这里插入图片描述

折腾了这么久，OpenClaw 总算是跑起来了！回头看看，虽然踩了几个坑，但好在都一一填平了：

npm 版本不兼容：Node 22 需要配一个足够新的 npm，否则安装脚本直接**。解决办法就是升级 npm 再重跑命令。
WSL2 的 systemd 没启用：这是最隐蔽也最致命的一环。OpenClaw 的网关依赖 systemd 作为后台服务，没它的话 gateway 根本起不来。记得在 /etc/wsl.conf 里配置 systemd=true，然后一定要在 PowerShell 里执行 wsl –shutdown 彻底重启 WSL，否则配置不生效。
网关启动后的 token 配置：第一次访问 Dashboard 时提示 gateway token missing，别慌，按照提示在网页上点几下生成一个 token 就好。

现在，浏览器里的 http://127.0.0.1:18789/ 已经能正常打开 OpenClaw 的控制面板，模型（我用的千帆）也配置好了。虽然飞书插件因为依赖缺失暂时没装上，但不影响核心功能，本地玩玩还是够用的了。

如果你也是那个在 Win + WSL2 上折腾 OpenClaw 的‘有缘人’，别光自己挠头，来评论区集合！把你的踩坑经历或通关秘籍扔进来，咱们一起把路铺平。

2026年手把手教你 Win11 + WSL2 装 OpenClaw：从环境配置到成功运行

相关推荐