保姆级教程！手把手教你在Win系统安装官方纯净OpenClaw
https://image.uisdc.com/wp-content/uploads/2026/03/ysbanner-20260316-3-1.webp一、全文速览图https://image.uisdc.com/wp-content/uploads/2026/03/Gemini_Generated_Image_3awipx3awipx3awi.webp所有用OpenClaw的朋友，我都劝你先装上这个能保命的Skill全文速览图 最近这段时间，只要我发关于OpenClaw的文章，评论区必有人在问同一件事。阅读文章 >
其实这个教程写到一半的时候，我发现各大厂已经开始出一键安装 OpenClaw了，然后我就有点纠结到底要不要继续写完，觉得大家应该已经不需要了？然后我就在群里问了下大家，没想到需要的人还是挺多。看了下群里大家的讨论，总结下"一键安装"可能有几个问题。第一个就是很多东西都被封装好了，反而更黑盒了。我当时装了一个，就不说名字了，就是看起来像是装上了，但到底装了什么、改了什么、为什么这样配，我并不清楚。然后要怎么改，感觉也挺懵的，还不如我之前折腾的原生官方版本。不少群友也觉得原装会更纯净，不会默认给你塞一堆你暂时用不上的插件和配置。整个过程你是清楚的，环境是自己搭起来的，后面要改配置、做排查、加插件，你心里都有数。我自己觉得还有一个很现实的点就是，安装过程本身，就是理解 OpenClaw 的过程。你不是只把它装上了，而是在这个过程中慢慢搞清楚，Windows 上为什么要先过 WSL2，为什么网络配置这么关键，为什么有些问题明明看起来像安装失败，本质上却是环境没弄对。所以我最终还是写完了这篇教程，目的不是为了跟一键安装比谁更快。而是想给那些想装得更稳、想少踩坑、也想顺便搞懂它是怎么一回事的人，留一份参考。废话不多说，下面开始正式教程。还是一样，先检查你的电脑环境，看是否能支持安装。在win上安装失败率比mac高，大部分都是因为环境导致的，所以这一步非常关键，大家一定要做好检查，这里一定要有耐心，只要跟着教程一步步来，一定能装上。二、环境准备1. 先按快捷键 win+R,输入winver
按回车，https://image.uisdc.com/wp-content/uploads/2026/03/64d7bd5129f9be92933c607aeeacb92e.webp在弹出的窗口中确认你电脑的版本。https://image.uisdc.com/wp-content/uploads/2026/03/a428270fe440d70faf0911a9bcbb71cd.webp像我电脑是windows11，基本上就没啥问题，如果是低于这个版本，建议先把电脑做下升级，不然有一堆bug等着你，比起解bug ，升级电脑版本最省事。2. 检查CPU虚拟化有没有开启这一步，是为了确认你的电脑有条件运行 WSL2，而 WSL2 又是 Windows 上稳定安装 OpenClaw 的基础。官方推荐的方式，在虚拟机上跑最安全稳定。按下快捷键 Ctrl+Shift+Esc然后切到性能，看下底下的虚拟化有没有启用。https://image.uisdc.com/wp-content/uploads/2026/03/bc6e32939ca7b28920ce174a18dde74a.webp一般正常是启用的状态，如果没有启用，那你也可以搜下相关教程或者问下AI怎么开，我这里就不展开了，以免篇幅太长。3. 安装虚拟机按下快捷键 win+X，在弹出的菜单中选择终端管理员，https://image.uisdc.com/wp-content/uploads/2026/03/f55abeb8624e585200bc84d6469199d4.webp就可以打开终端命令操作。https://image.uisdc.com/wp-content/uploads/2026/03/3e8c642f83a25967cbfcf4ba1a500bd4.webp然后复制这个命令到打开的终端里，wsl --install
一键安装WSLhttps://image.uisdc.com/wp-content/uploads/2026/03/fa2cf3fd138af00e36aee0a80432a8fb.webp到这里它会让你创建用户名，比如caiyun，注意：一定要小写字母且不能是数字开头也不要加其他符号，回车继续。接着让你输入密码，比如123456，这里输入密码是不可见的，要输入2次，建议别搞太复杂，怕错。https://image.uisdc.com/wp-content/uploads/2026/03/6a5f2f2dfdc068985615fe719d5aaa92.webp这里的账号密码要记住，后面会用到。然后这一步的内容就安装完了。https://image.uisdc.com/wp-content/uploads/2026/03/b5bcd0f1b8847f93c69ef8eca2d4221b.webp到这一步就需要重启下电脑，刚才安装的东西才会生效。4. 再次确认下安装环境，检查下是否安装成功。我前面说过，环境不对，后面就会遇上各种报错，所以我们保险一点，再确认一次。还是一样，按快捷键 win+x，选择终端管理员，然后输入wsl --list --verbose
看下版本这里的数字是不是2，如果是的话，就没问题。https://image.uisdc.com/wp-content/uploads/2026/03/1b9f66f20baf987532a48f1e1a234e88.webp5. 继续整环境。这一步，我们需要把网络环境弄好。在C盘打开这个文件目录https://image.uisdc.com/wp-content/uploads/2026/03/1baa20a4ed9bb2b4de626105a1a1422e.webp用记事本创建一个文件，后缀名是.wslconfig然后把下面的配置代码贴进去。#启用镜像网络模式 - 这是最重要的配置networkingMode=mirrored#启用 DNS 隧道，防止 VPN 环境下域名解析失效dnsTunneling=true#强制 WSL 使用 Windows 的 HTTP 代理设置autoProxy=true#启用集成防火墙支持firewall=true#自动回收闲置内存，优化性能autoMemoryReclaim=gradual#支持主机回环地址访问hostAddressLoopback=true
点保存文件，后缀是.wslconfig，不是.txthttps://image.uisdc.com/wp-content/uploads/2026/03/d6c6ce5d44b19515bf48cfe1f2c736ce.webp6. 继续打开终端，输入wsl --shutdown
让它重启下服务7. 验证网络打开Ubuntu，前面已经用命令行装过了，从开始菜单那能找到https://image.uisdc.com/wp-content/uploads/2026/03/13b037a8a44ab1fa73f9de8712d6a35b.webp输入ip addr show
看到下面的结果就说明没问题了，https://image.uisdc.com/wp-content/uploads/2026/03/1347b20eb1c6b23fc93a132a28a03913.webp如果发现没有2:eth0 这个变量，很可能就是上一个文件没有放对目录。我当时就遇到了这个问题，粗暴的解决方案就是把这个文件多放几个地方，就能搞定。https://image.uisdc.com/wp-content/uploads/2026/03/7d4d1f79cc8e6a1dd026e24a69b7f88d.webp如果你那边的结果跟我的不一样，也可以把结果发给AI，让它给你判断。如果还是没有出现eth0，直接加群问我要文件吧。因为这一步没搞定，后面网络通信就会出问题，安装就不会成功。再说一次，一定要确保每一步都是正确的，再往下一步走。如果你拿不准，就把你碰到的结果全部复制下来发给AI，让AI帮你判断，不然很可能到后面出错，你都找不到到底哪一步错了。咱们走稳一些，每一步都是学习。8. 设置防火墙为了确保 OpenClaw 的网络端口能够被正确访问，需要配置 Windows 防火墙规则。这里有一些细节要注意，你得把PowerShell升级到最新版本，如果万一出问题，可以问下AI怎么升级，我这里也不展开，比较简单。输入命令：New-NetFirewallRule -DisplayName "OpenClaw-Service" -Direction Inbound -Action Allow -Protocol TCP -LocalPort 18789
https://image.uisdc.com/wp-content/uploads/2026/03/2c1d836feece0ce3ead61bd278ade4c7.webp再输入命令，确认是否成功。Get-NetFirewallRule -DisplayName "OpenClaw-Service" | Format-Table
https://image.uisdc.com/wp-content/uploads/2026/03/3962e346842d628d621a404014bebd0b.webp9. 设置Ubuntu从这里开始，就是要在Ubuntu里进行设置了，把Ubuntu应用打开，然后开始配置。为了在后续安装脚本运行中避免频繁输入密码，咱们开启下 sudo 免密权限，输入sudo visudo
https://image.uisdc.com/wp-content/uploads/2026/03/4364f84b45fc32033a2cb1530e229e45.webp输入密码，之前有设置过，把它填过来。滑到底，然后输入这段代码xxx ALL=(ALL) NOPASSWD: ALL
按方向键左移，然后把xxx改成你自己创建的用户名。改完之后，按Ctrl+Ohttps://image.uisdc.com/wp-content/uploads/2026/03/2b6a9fbf216394b6c422b24c42589184.webp按 Enterhttps://image.uisdc.com/wp-content/uploads/2026/03/88b187574bddd9e2547344fafc17c278.webp再按快捷键 Ctrl+Xhttps://image.uisdc.com/wp-content/uploads/2026/03/2c4008eea507fac4be7d1bbbaf8fc52b.webp10. 安装基础工具这一步是把后面安装过程中会用到的一些基础工具先装好，比如 curl 用来下载安装脚本，git 用来拉代码。提前装好这些工具，可以避免后面安装时报缺少依赖的错误。继续在Ubuntu里输入下面这条命令，sudo apt install -y curl wget git
因为我已经装过了，所以会显示这个https://image.uisdc.com/wp-content/uploads/2026/03/6d5877ee10eb1d8caf4cee0d88a92dfa.webp三、正式安装好了，到这里终于开始准备安装了。其实现在就比较简单了，看过我上一篇mac篇安装教程的同学应该可以不用看了，流程基本上是一模一样的。先输入这个官方代码curl -fsSL https://molt.bot/install.sh | bash
https://image.uisdc.com/wp-content/uploads/2026/03/e33b5cd9414af4c943ba01462ec34b31.webp等它下载完，自动安装。这个过程需要等一些时间，取决于你的网速。到这里就说明已经安装好了，然后开始进行配置项了。https://image.uisdc.com/wp-content/uploads/2026/03/64f1c57c0fbc5245eb7e0373e158aaf5.webp选yeshttps://image.uisdc.com/wp-content/uploads/2026/03/3071ed05be22e70882813ab8f4b7548d.webp选择快速开始。https://image.uisdc.com/wp-content/uploads/2026/03/ba6efa40b40eea5bb5b6aaea1a959287.webp我有chatGPT plus会员，所以就直接选第一个。https://image.uisdc.com/wp-content/uploads/2026/03/37cec7b4f6b1418e867a2dd3741075b8.webp继续选第一个。https://image.uisdc.com/wp-content/uploads/2026/03/0d04dbbd799e14d98d26c8531ccda243.webp如果发现它没法自动打开浏览器，那可以手动把链接复制到浏览器中。这里可能会跟mac不一样，因为mac是可以自动跳转的，win需要手动一下。https://image.uisdc.com/wp-content/uploads/2026/03/d6a52ae8df02222d8a72c138bc85a921.webp包括它的信息不会从浏览器返回，也可以手动复制这个链接，贴回终端，就可以继续了。https://image.uisdc.com/wp-content/uploads/2026/03/58034d191d0fd24c2d72f96b16d303c3.webp直接选第一个，选最新的模型5.4。https://image.uisdc.com/wp-content/uploads/2026/03/61d6117e9015e5f1dd3392ac867919eb.webp接着选聊天工具，我们先跳过，后面再配置https://image.uisdc.com/wp-content/uploads/2026/03/4343ee2c12826a7a4b0c080a44f58d80.webp继续跳过https://image.uisdc.com/wp-content/uploads/2026/03/3f147dfe724581a7ec8fed43d0fabbae.webp选no，我们也先跳过，后面再说https://image.uisdc.com/wp-content/uploads/2026/03/baa23d6bbd47a32f1510c6a698454919.webp也先跳过https://image.uisdc.com/wp-content/uploads/2026/03/1a2bc72ffbc4a639e075296461d7ff62.webp先跳过。https://image.uisdc.com/wp-content/uploads/2026/03/fc2377b519e7102456b3f7a954d2fc02.webp选第二个，就可以在网页中聊天。https://image.uisdc.com/wp-content/uploads/2026/03/f0023545973300482d37867bd5640366.webp到这里就安装完了。但win上比较麻烦的就是它没有自动跳转到网页浏览器，我们往上滚动，复制这个链接到浏览器中就可以打开。打开网页后就是这样。https://image.uisdc.com/wp-content/uploads/2026/03/b7197fa11e8a83fb9fd62e14d6669c59.webp我们跟它说句话。https://image.uisdc.com/wp-content/uploads/2026/03/70598516cc7965b29649d5bc0c3a9c79.webp后面就开始做其他配置了，输入openclaw config（并在终端中回车）
https://image.uisdc.com/wp-content/uploads/2026/03/c5a8456e862f3b0bcee8e0be67df4d20.webp选择localhttps://image.uisdc.com/wp-content/uploads/2026/03/25be1c4a980a0f75784d5125e1eca813.webp选channelshttps://image.uisdc.com/wp-content/uploads/2026/03/8d2e74c7d37af39f29d84c52e21b782d.webp继续选Configure/link后面就开始配置飞书了，配置好，同样可以在飞书里跟你的虾聊天当牛马。https://image.uisdc.com/wp-content/uploads/2026/03/4ab32f7ed88cc646c7fea41ee2059049.webp最后写到这里，这篇Windows上安装原生OpenClaw的教程就差不多结束了。如果你只是想赶紧体验一下，网上那些一键安装当然也可以，省时间，适合先跑起来看看。但如果你希望自己装得更稳一点，想自己好好的从头开始养虾，玩明白，那原生安装这条路还是值得走一遍。因为很多时候，真正有价值的，不只是装好了这件事，而是你知道它为什么能装好，哪一步最关键，报错了该往哪里查。这也是我一直在用的学习方式。不要只追求快，也要尽量让自己看懂过程。你现在多走的这几步，后面都会慢慢变成你的经验。如果你在安装过程中卡住了，也别慌，慢慢来，总能解决，我第一次在win上安装也花了2天时间。后面再配置mac的时候就觉得太过简单了，因为我已经通过前两天的折腾弄明白它是怎么回事了。反而“因祸得福”，学到了更多东西。先把它装明白，再去玩插件、skills、自动化这些东西，会轻松很多。咱们走稳一点，后面反而更快。后面，我再教大家点养虾技巧，毕竟安装只是第一步，把虾养好才能发挥它真正的价值。保持关注吧~https://image.uisdc.com/wp-content/uploads/2026/03/Gemini_Generated_Image_eoqyh4eoqyh4eoqy.webp欢迎关注作者的微信公众号：「彩云译设计」
页:
[1]