保姆级教程！手把手教你在Win系统安装官方纯净OpenClaw

一、全文速览图

其实这个教程写到一半的时候，我发现各大厂已经开始出一键安装 OpenClaw了，然后我就有点纠结到底要不要继续写完，觉得大家应该已经不需要了？

然后我就在群里问了下大家，没想到需要的人还是挺多。

看了下群里大家的讨论，总结下"一键安装"可能有几个问题。

第一个就是很多东西都被封装好了，反而更黑盒了。我当时装了一个，就不说名字了，就是看起来像是装上了，但到底装了什么、改了什么、为什么这样配，我并不清楚。然后要怎么改，感觉也挺懵的，还不如我之前折腾的原生官方版本。

不少群友也觉得原装会更纯净，不会默认给你塞一堆你暂时用不上的插件和配置。整个过程你是清楚的，环境是自己搭起来的，后面要改配置、做排查、加插件，你心里都有数。

我自己觉得还有一个很现实的点就是，安装过程本身，就是理解 OpenClaw 的过程。

你不是只把它装上了，而是在这个过程中慢慢搞清楚，Windows 上为什么要先过 WSL2，为什么网络配置这么关键，为什么有些问题明明看起来像安装失败，本质上却是环境没弄对。

所以我最终还是写完了这篇教程，目的不是为了跟一键安装比谁更快。

而是想给那些想装得更稳、想少踩坑、也想顺便搞懂它是怎么一回事的人，留一份参考。

废话不多说，下面开始正式教程。

还是一样，先检查你的电脑环境，看是否能支持安装。在win上安装失败率比mac高，大部分都是因为环境导致的，所以这一步非常关键，大家一定要做好检查，这里一定要有耐心，只要跟着教程一步步来，一定能装上。

二、环境准备

1. 先按快捷键 win+R,输入

winver

按回车，

在弹出的窗口中确认你电脑的版本。

像我电脑是windows11，基本上就没啥问题，如果是低于这个版本，建议先把电脑做下升级，不然有一堆bug等着你，比起解bug ，升级电脑版本最省事。

2. 检查CPU虚拟化有没有开启

这一步，是为了确认你的电脑有条件运行 WSL2，而 WSL2 又是 Windows 上稳定安装 OpenClaw 的基础。官方推荐的方式，在虚拟机上跑最安全稳定。

按下快捷键 Ctrl+Shift+Esc

然后切到性能，看下底下的虚拟化有没有启用。

一般正常是启用的状态，如果没有启用，那你也可以搜下相关教程或者问下AI怎么开，我这里就不展开了，以免篇幅太长。

3. 安装虚拟机

按下快捷键 win+X，在弹出的菜单中选择终端管理员，

就可以打开终端命令操作。

然后复制这个命令到打开的终端里，

wsl --install

一键安装WSL

到这里它会让你创建用户名，比如caiyun，注意：一定要小写字母且不能是数字开头也不要加其他符号，回车继续。

接着让你输入密码，比如123456，这里输入密码是不可见的，要输入2次，建议别搞太复杂，怕错。

这里的账号密码要记住，后面会用到。

然后这一步的内容就安装完了。

到这一步就需要重启下电脑，刚才安装的东西才会生效。

4. 再次确认下安装环境，检查下是否安装成功。

我前面说过，环境不对，后面就会遇上各种报错，所以我们保险一点，再确认一次。

还是一样，按快捷键 win+x，选择终端管理员，然后输入

wsl --list --verbose

看下版本这里的数字是不是2，如果是的话，就没问题。

5. 继续整环境。这一步，我们需要把网络环境弄好。

在C盘打开这个文件目录

用记事本创建一个文件，后缀名是.wslconfig

然后把下面的配置代码贴进去。

[wsl2]
#启用镜像网络模式 - 这是最重要的配置
networkingMode=mirrored
#启用 DNS 隧道，防止 VPN 环境下域名解析失效
dnsTunneling=true
#强制 WSL 使用 Windows 的 HTTP 代理设置
autoProxy=true
#启用集成防火墙支持
firewall=true
[experimental]
#自动回收闲置内存，优化性能
autoMemoryReclaim=gradual
#支持主机回环地址访问
hostAddressLoopback=true

点保存文件，后缀是.wslconfig，不是.txt

6. 继续打开终端，输入

wsl --shutdown

让它重启下服务

7. 验证网络

打开Ubuntu，前面已经用命令行装过了，从开始菜单那能找到

输入

ip addr show

看到下面的结果就说明没问题了，

如果发现没有2:eth0 这个变量，很可能就是上一个文件没有放对目录。我当时就遇到了这个问题，粗暴的解决方案就是把这个文件多放几个地方，就能搞定。

如果你那边的结果跟我的不一样，也可以把结果发给AI，让它给你判断。

如果还是没有出现eth0，直接加群问我要文件吧。因为这一步没搞定，后面网络通信就会出问题，安装就不会成功。

再说一次，一定要确保每一步都是正确的，再往下一步走。如果你拿不准，就把你碰到的结果全部复制下来发给AI，让AI帮你判断，不然很可能到后面出错，你都找不到到底哪一步错了。

咱们走稳一些，每一步都是学习。

8. 设置防火墙

为了确保 OpenClaw 的网络端口能够被正确访问，需要配置 Windows 防火墙规则。这里有一些细节要注意，你得把PowerShell升级到最新版本，如果万一出问题，可以问下AI怎么升级，我这里也不展开，比较简单。

输入命令：

New-NetFirewallRule -DisplayName "OpenClaw-Service" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 18789

再输入命令，确认是否成功。

Get-NetFirewallRule -DisplayName "OpenClaw-Service" | Format-Table

9. 设置Ubuntu

从这里开始，就是要在Ubuntu里进行设置了，把Ubuntu应用打开，然后开始配置。

为了在后续安装脚本运行中避免频繁输入密码，咱们开启下 sudo 免密权限，输入

sudo visudo

输入密码，之前有设置过，把它填过来。

滑到底，然后输入这段代码

xxx ALL=(ALL) NOPASSWD: ALL

按方向键左移，然后把xxx改成你自己创建的用户名。

改完之后，按Ctrl+O

按 Enter

再按快捷键 Ctrl+X

10. 安装基础工具

这一步是把后面安装过程中会用到的一些基础工具先装好，比如 curl 用来下载安装脚本，git 用来拉代码。提前装好这些工具，可以避免后面安装时报缺少依赖的错误。

继续在Ubuntu里输入下面这条命令，

sudo apt install -y curl wget git

因为我已经装过了，所以会显示这个

三、正式安装

好了，到这里终于开始准备安装了。其实现在就比较简单了，看过我上一篇mac篇安装教程的同学应该可以不用看了，流程基本上是一模一样的。

先输入这个官方代码

curl -fsSL https://molt.bot/install.sh | bash

等它下载完，自动安装。这个过程需要等一些时间，取决于你的网速。

到这里就说明已经安装好了，然后开始进行配置项了。

选yes

选择快速开始。

我有chatGPT plus会员，所以就直接选第一个。

继续选第一个。

如果发现它没法自动打开浏览器，那可以手动把链接复制到浏览器中。这里可能会跟mac不一样，因为mac是可以自动跳转的，win需要手动一下。

包括它的信息不会从浏览器返回，也可以手动复制这个链接，贴回终端，就可以继续了。

直接选第一个，选最新的模型5.4。

接着选聊天工具，我们先跳过，后面再配置

继续跳过

选no，我们也先跳过，后面再说

也先跳过

先跳过。

选第二个，就可以在网页中聊天。

到这里就安装完了。

但win上比较麻烦的就是它没有自动跳转到网页浏览器，我们往上滚动，复制这个链接到浏览器中就可以打开。

打开网页后就是这样。

我们跟它说句话。

后面就开始做其他配置了，输入

openclaw config（并在终端中回车）

选择local

选channels

继续选Configure/link

后面就开始配置飞书了，配置好，同样可以在飞书里跟你的虾聊天当牛马。

最后

写到这里，这篇Windows上安装原生OpenClaw的教程就差不多结束了。

如果你只是想赶紧体验一下，网上那些一键安装当然也可以，省时间，适合先跑起来看看。

但如果你希望自己装得更稳一点，想自己好好的从头开始养虾，玩明白，那原生安装这条路还是值得走一遍。

因为很多时候，真正有价值的，不只是装好了这件事，而是你知道它为什么能装好，哪一步最关键，报错了该往哪里查。

这也是我一直在用的学习方式。

不要只追求快，也要尽量让自己看懂过程。你现在多走的这几步，后面都会慢慢变成你的经验。

如果你在安装过程中卡住了，也别慌，慢慢来，总能解决，我第一次在win上安装也花了2天时间。后面再配置mac的时候就觉得太过简单了，因为我已经通过前两天的折腾弄明白它是怎么回事了。反而“因祸得福”，学到了更多东西。

先把它装明白，再去玩插件、skills、自动化这些东西，会轻松很多。

咱们走稳一点，后面反而更快。

后面，我再教大家点养虾技巧，毕竟安装只是第一步，把虾养好才能发挥它真正的价值。保持关注吧~

欢迎关注作者的微信公众号：「彩云译设计」