GitHub狂揽23万Stars的OpenClaw:Windows一键部署,30分钟搭建你的私人AI助手
前言23万Stars是什么概念OpenClaw在GitHub上的增长曲线几乎是垂直拉升的——2025年11月开源到今年初已经突破了23万Star成为开源史上增长最快的AI项目之一。这个数字不是刷出来的是全球开发者真金白银点出来的认可。OpenClaw本质上是一个本地AI网关部署在你自己的电脑上接入大模型之后能直接操控文件系统、执行脚本、发消息真正把AI从聊天对象变成干活工具。你可以用它管理文件、写代码、远程控制智能家居或者接进飞书/微信/Telegram让AI在通讯软件里直接替你办事。关键在于——它在Windows上可以一键部署。Node.js环境准备好一行命令跑完中间基本不用手动干预。官方给了一键安装脚本即使你是技术小白跟着步骤走30分钟之内也能跑起来。这篇文章就是你的Windows部署指南从装环境到配模型到cpolar公网穿透全程走完。这篇文章将手把手带你完成OpenClaw在Windows 系统上的部署即使你是技术小白也能轻松上手。1 什么是OpenClawOpenClaw 是一个开源的个人 AI 助手网关2025 年 11 月正式开源截至目前已在 GitHub 收获230K Stars成为开源史上增长最快的 AI 项目之一。它可以运行在你的电脑或服务器上通过它能把各种 AI 能力如 Claude、Pi、ChatGPT 等接入到日常使用的通讯工具中——飞书、钉钉、Telegram、Discord、iMessage、WhatsApp 等实现一个 AI 助手多个平台同时在线。简单来说OpenClaw 就像一个长在你电脑里的数字员工你通过微信、飞书、钉钉、Telegram 发消息它在后台操控电脑帮你干活发文件、查资料、写代码、控制智能家居…无所不能2 环境准备与依赖安装本教程演示在 Windows 操作系统上进行部署。在运行 OpenClaw前必须要安装两样基础工具Node.js和Git。官方虽然提供的一键脚本即可安装Nodejs和Git但是可能存在网络问题所以这里更建议小伙伴们手动安装一下2.1 安装Node.js环境在给电脑安装上node.js环境这里推荐使用nvm进行安装nvm是node.js的版本管理器可以方便地切换不同版本的node.js。首先打开nvm的github仓库当前最新版本1.2.2发布页面https://github.com/coreybutler/nvm-windows/releases/tag/1.2.2下载下来后双击执行启动安装程序【nvm-setup.exe】然后选择同意协议点击下一步【Next】:来到选择安装目录这里选择【D:\nvm】将nvm安装在D盘中然后继续点击【Next】:接着设置nodejs的下载位置这里直接也选择下载在nvm文件夹中继续点击【Next】接下来一路选择【Next】即可过程中的复选框及邮箱地址都可以不用修改和输入直到最后一步点击【install】即可安装完成后来到刚才安装nvm的位置【D:\nvm】双击打开【settings.txt】文件粘贴如下代码然后按【ctrl s】保存node_mirror: https://npmmirror.com/mirrors/node/ npm_mirror: https://npmmirror.com/mirrors/npm/该地址为国内淘宝镜像源添加后可以更快的下载nodejs环境接下来电脑按【WinR】输入【cmd】,然后进行回车打开cmd窗口输入如下命令进行查看版本是否安装nvm-v然后依次输入如下命令安装nodejs环境需要22版本及以上以及启用该版本nvminstall22nvm use22.20.0node-vnpm-v安装完成后使用该版本然后验证node环境版本确认是否生效如下图这样就成功安装好了nodejs啦通过nvm管理器后续可以用同样操作很方便地安装和切换不同版本的nodejs。2.2 安装Git环境安装完成nodejs后接下来就是安装git环境git是代码管理工具在部署openclaw时需要从github上下载openclaw的源码所以需要安装git环境。首先打开git的下载页面直接下载即可git版本没有要求下载下来后直接双击启动安装程序然后一直点击【Next】即可到最后点击【Install】就行其他相关配置可以保持默认安装完成后可以重新进入cmd窗口输入如下命令进行验证版本git--version如下图输出版本信息就安装成功啦3 一键部署OpenClaw安装完成nodejs和git环境后接下来就是部署openclaw了。这里推荐使用一键部署脚本官方提供多种部署方式包括cmd、powershell、npm、pnpm等这里以PowerShell为例进行演示。3.1 解决PowerShell执行脚本问题首先电脑按【Win X】选择【终端/PowerShell】进行打开打开后可能会出现如下图所示提示为【在此系统上禁止运行脚本】这是因为PowerShell默认禁止运行脚本我们可以输入如下命令进行允许执行脚本Set-ExecutionPolicy-ExecutionPolicyRemoteSigned-ScopeCurrentUser执行以后重新打开【PowewrShell】就不会出现该提示了3.2 执行一键部署脚本接下来我们在PowerShell终端输入如下命令进行一键部署iwr -useb https://openclaw.ai/install.ps1 | iex如下图所示可以看到跳过了nodejs的安装直接开始安装OpenClaw了等待OpenClaw安装安装时长取决于你的网络耐心等待即可安装完成如下图所示等待初始化接着来到如下页面按键盘的左右键进行选择切换到【YES】然后回车同意上述风险后选择【QuickStart】即代表快速开始然后进行回车接着来到选择 【AI大脑供应商】页面也就是给OpenClaw配置一个AI大模型这里推荐选择【MiniMax、Qwen、硅基流动】等平台例如MiniMax首次新用户注册有【15元】的额度体验或者选择Qwen千问新用户注册有每个模型都有100w的tokens进行体验。由于我这两个平台额度都已经用完了qwq。所以这里以硅基流动为例。首先访问如下地址来到硅基流动的注册登录界面注册登录后来到左侧活动中心下的认证专享礼部分可以领取一张【16元】的认证奖励券接着有了额度以后即可将其接入到我们部署的OpenClaw中了。点击侧边栏的【API密钥】然后进行新建密钥创建好以后点击【复制】按钮将密钥复制下来备用接着继续回到PoweShell终端的配置OpenClaw界面用键盘上下选择【Custom Provider】回车进行自定义配置在【API Base URL】这一栏中将默认的地址去掉填写如下【硅基流动】的Base API地址https://api.siliconflow.cn/v1接下来粘贴刚才复制好的【API Key】,然后继续回车接下来选择API 接口Endpoints兼容,默认为【OpenAI-compatible】直接回车即可回车后输入模型Code即代表你要使用的模型可以在模型广场选择一个你要使用的模型Code,这里以【Pro/MiniMaxAI/MiniMax-M2.5】为例复制整个名称然后回到配置界面输入该模型Code接着回车等待验证提示【Verification successful】即代表验证成功接入成功了接着【Endpoint ID】项直接回车来到模型别名部分随意设置一个直接回车即可回车后来到下方选择【channel】部分这里是配置消息平台可以接入飞书等平台这里优先跳过可以以后配置直接选选择最底下跳过即可接着来到技能配置项直接选择【No】即可以后配置即可来到【Enable hooks】项可以按需选择这里选择全部启用建议启用包含命令历史、记忆功能等选择对应的按【空格】键即可选中选中后回车即开始安装【Gateway】安装完成后会弹出新的窗口进行启动OpenClaw的GateWay服务在原来配置的PowerShell选择【Open the Web UI】后会自动跳转浏览器打开打开后就是OpenClaw的聊天界面接着可以进行对话测试测试是否正常比如你好你是谁你当前运行在什么操作系统上接入你的大模型是什么请你详细回答谢谢可以看到询问提示出现了问题这是由于自定义接入的API配置文件中默认的上下文tokens是4096我们需要修改【openclaw.json】配置文件。回到配置的PowerShell窗口往上寻找可以看到配置文件所在的位置这里显示为如下目录位置其中的admin为对应你的用户目录中的名称即登录电脑时显示的名称C:\Users\admin\.openclaw\openclaw.json我们直接打开资源管理器在地址栏输入它的路径【C:\Users\admin.openclaw\】然后进行回车选中该文件右键然后选择【打开方式】用记事本打开即可其他的编辑工具也可以找到模型配置的部分修改【contextWindow】和【maxTokens】参数的值为如下contextWindow:200000,maxTokens:8192如下图中配置所示修改完成后按【Ctrl S】键进行保存保存后叉掉即可。然后回到网页中再次询问你好你是谁你当前运行在什么操作系统上接入你的大模型是什么请你详细回答谢谢可以看到成功的回答了甚至还知道它运行在哪儿给它配置的是什么模型这样你的AI助手就配置成功了4 硬核实测一句话让AI接管电脑替你干活装好了 OpenClaw这可不是一个只能陪你闲聊的普通 AI。它真正厉害的地方在于**能直接读取和操控你的电脑替你完成各种繁杂的任务。**这不就相当于白嫖了一个 24 小时待命的“赛博打工人”吗下面带你看看这几个极其真实的实操场景看完你就知道它有多强大了4.1 场景一一句话找回遗忘在家里的重要文件你是不是也有过这种绝望的时刻人都打卡到公司了往椅子上一坐才猛然想起来昨天晚上在家加班赶出来的关键发票或者方案文档竟然还在家里的电脑桌面上没发出来以前只能请假跑回家拿现在只要你家里的电脑开着机并连着 OpenClaw你直接在手机里发一条消息给它我昨天在桌面上放了一个带“元旦”两个字的 docx 方案文件你帮我找一下找到后直接发送给我。可以看到当前聊天窗口似乎并不能直接让它发送文件过来于是继续交流可以看到它能够成功的定位到微信打开微信然后搜索【文件传输助手】再把文件发送过来(绝对真实)。让我们问一下它是怎么做到的可以看到它说它是通过模拟人工操作通过键盘鼠标自动化来假装是我在操作微信。它还尝试了多种方式最后终于成功的发送了哈哈它还会说“普通 UI 自动化库不太好用”真的是又厉害还可爱4.2 场景二一句话写全套代码并部署跑起来比如你想临时做一个“个人简历”的漂亮网页你可以这样指挥它帮我写一个个人简历的 HTML 页面样式要做得现代、好看一点。 我的具体信息如下 - **姓名**苏苏 - **求职意向**新媒体运营专员 - **个人优势**熟悉各大自媒体平台规则脑洞大能独立完成爆款图文及短视频策划。 - **工作经历**1.2023.07-至今在某某文化传媒公司担任新媒体运营负责公司小红书账号0-1起盘单月涨粉超5万。2.2022.03-2023.06在某某科技公司担任新媒体实习生参与策划过百万播放量的短视频项目。 - 帮我简单补充一些排版需要的背景或细节部分。 写完后帮我在 D 盘新建一个叫 resume 的文件夹把它放进去然后想办法直接把它在本地运行起来最后发给我一个能在浏览器里直接点开预览的网页链接。可以看到它成功的给我做好了还和我说运行起来了。让我访问一下这个链接看看可以发现成功的访问到了它真给我部署起来了但是当前访问的是局域网地址如果我在外面的话肯定看不到它给我生成的这个页面所以需要和它再说一下你给我的这个是局域网地址我无法查看我现在在外面我的电脑上好像有cpolar,你看一下你把这个穿出来给我要公网地址我才可以访问可以看到它说创建好了让我复制一下这个地址访问一下看看看是否真的能够访问到https://2da332f.r3.nas.cpolar.cn访问出现404了让我们继续询问它我访问你给我的这个链接显示404没有看到页面可以看到它又给了一个新的地址让我们访问这个新的链接看看https://15d2d9c9.r3.nas.cpolar.cn哇可以发现它竟然真的通过我电脑上的cpolar把你刚才生成的网页给穿透出来了随时随地在公网都能访问不需要你手动敲什么繁琐的命令也不用懂复杂的网络配置就跟指挥真人下属一样聊两句天它就帮你打通了“写代码 - 本地部署 - 内网穿透”的全套流程。这种仿佛拥有了“贾维斯”一样的全自动化体验实在是太震撼了进阶玩法提示这两个小场景只是它的冰山一角。你能让它做的事情完全取决于你的想象力无论是大批量重命名文件、分析庞杂的 Excel 表格、一键帮你发邮件汇报进度甚至是在你出门时让它直接帮你把家里的电脑休眠关机它统统都能胜任。这么科幻的赛博小助理赶紧亲自去调教试试吧5 下载安装cpolar虽然上面我们在局域网里把 OpenClaw 跑得风生水起但目前它只能通过内网进行访问。这意味着只有你正坐在家里的电脑前才能召唤这位数字助手。一旦你出门上班、在地铁上切换到 4G/5G 网络或者去外地出差当你急需让它帮你找文件或控制家里设备时都会因为不在同一个内网而直接连接失败。要让这套“赛博打工人”系统真正发挥出随时随地待命的威力你就必须让它能够被公网访问。传统的做法那是相当折腾你需要去购买昂贵的云服务器、配置复杂的公网 IP、甚至还要走一套域名备案的流程……不仅费钱费时对技术小白来说更是处处是坑。但好消息是借助cpolar 内网穿透这款安全强大的工具你可以零成本、几分钟内就把本地的 OpenClaw 服务映射到公网生成一个稳定且安全的 HTTPS 地址。无论你身在何处只要有网随时都能唤醒你的私人助手接下来我们就来配置 cpolar让你的私有 AI 助手彻底打破局域网的限制5.1 什么是cpolar?cpolar 是一款内网穿透工具可以将你在局域网内运行的服务如本地 Web 服务器、SSH、远程桌面等通过一条安全加密的中间隧道映射至公网让外部设备无需配置路由器即可访问。广泛支持Windows、macOS、Linux、树莓派、群晖 NAS等平台并提供一键安装脚本方便部署。5.2 下载安装cpolar打开cpolar官网的下载页面点击立即下载 64-bit按钮,下载cpoalr的安装包:下来下来是一个压缩包,解压后执行目录种的应用程序,一路默认安装即可,安装完成后,打开cmd窗口输入如下命令确认安装:cpolar version出现如上版本即代表安装成功!5.3 注册及登录cpolar web ui管理界面访问cpolar官网点击免费注册按钮进行账号注册进入到如下的注册页面进行账号注册注册完成后,在浏览器中输入如下地址访问 web ui管理界面:http://127.0.0.1:9200输入刚才注册好的cpolar账号登录即可进入后台页面:6 穿透OpenClaw以实现公网访问刚才我们已经成功安装并登录了 cpolar万事俱备只欠东风。接下来我们只需要将运行在本地的 OpenClaw 服务默认端口通常为18789通过 cpolar 映射出去就能立刻获得一个公网访问地址。6.1 随机域名方式(免费方案)随机域名方式适合预算有限的用户。使用此方式时系统会每隔24 小时左右自动更换一次域名地址。对于长期访问的不太友好但是该方案是免费的如果您有一定的预算可以查看大纲6.2的固定域名方式且访问更稳定。点击左侧菜单栏的隧道管理展开进入隧道列表页面页面下默认会有 2 个隧道remoteDesktop隧道指向3389端口tcp协议website隧道指向8080端口http协议http协议默认会生成2个公网地址一个是http另一个https免去配置ssl证书的繁琐步骤点击编辑website的隧道设置一个隧道名称,协议选择【http】,本地地址填写openclaw的访问端口【18789】地区这里选择的【China Top】最后点击更新接着点击左侧菜单的【状态】菜单接着点击【在线隧道列表】菜单按钮可以看到有2个astrbot-6185的隧道一个为http协议,另一个为https协议:接下来在浏览器中访问openclaw隧道生成的公网地址http和https皆可这里以https为例注意每个用户创建的隧道显示的公网地址都不一样可以看到成功的访问到了openclaw的页面但是页面上出现了一个错误提示如下origin not allowed(open the Control UI from the gatewayhostor allow itingateway.controlUi.allowedOrigins)这个错误提示的意思是不允许访问从网关主机打开控制界面或在网关.controlUi.allowedOrigins中允许它所以我们需要修改【openclaw】的配置文件允许公网访问。我们可以直接在原来本地的openclw聊天界面中和openclaw对话让它帮我们修改配置文件如下# 将对话中的域名修改为您cpolar穿透后对应的公网域名地址我将openclaw的webui界面18789端口通过cpolar穿透至公网了域名地址是https://1cf1b8b8.r1.cpolar.top但是访问页面提示origin not allowed需要在网关.controlUi.allowedOrigins中允许它请你帮我修改一下openclaw的配置文件允许它改完后并且重启openclaw网关等待它修改改完后网关会自动重启改完后可以询问它是否修改好了如提示已经添加让我们再次访问穿透后的地址测试可以看到错误提示换了证明刚才问题修复了这次是没有携带Token访问我们可以回到本地的openclw聊天界面【概览】菜单中复制接着回到穿透的界面进入【概览】菜单中粘贴复制的网关令牌然后点击连接点击连接后会看到右边会出现如下提示pairing required 此设备需要网关主机的配对批准。 openclaw devices list openclaw devices approverequestId在手机上从桌面运行 openclaw dashboard --no-open 复制完整 URL包括#token...。Docs: Device pairing我们需要回到终端cmd窗口或者PowerShell页面依次输入如下命令openclaw devices list# 注意需要将 requestId 替换成 Request 中的id字符串openclaw devices approverequestId如下图操作执行完成如上操作后即可在概览页面发现健康状态为【正常】了错误提示也消失啦此时我们再进行询问就可以发现能够正常对话啦这样openclaw就成功通过cpolar穿透至公网了即使出门在外只要有网络就可以随时随地访问你部署在家中的openclaw了。6.2 固定域名方式通过前面的配置我们已经成功实现了OpenClaw的远程访问但免费随机域名方案的局限性也逐渐显现每24小时左右自动更换域名地址意味着你需要频繁更新书签、重新分享链接甚至可能因为忘记更新而无法访问。固定域名方案正是为了解决这些痛点而生能够让你拥有一个永久不变的专属地址。好啦接下来开始固定保留二级子域名教程首先进入官网的预留页面:https://dashboard.cpolar.com/reserved选择预留菜单即可看到保留二级子域名项填写其中的地区、名称、描述可不填项然后点击保留按钮操作步骤图如下列表中显示了一条已保留的二级子域名记录地区显示为China Top。二级域名显示为openclaw。注二级域名是唯一的每个账号都不相同请以自己设置的二级域名保留的为主接着进入侧边菜单栏的隧道管理下的隧道列表可以看到名为openclaw的隧道点击编辑按钮进入编辑页面修改域名类型为二级子域名然后填写前面配置好的子域名点击更新按钮来到状态菜单下的在线隧道列表可以看到隧道名称为openclaw的公网地址已经变更为二级子域名固定域名主体及后缀的形式了这里以https协议做访问测试加载稍慢需耐心等待一下:可以看到出现了和前面一样的提示只需要用前面同样的方式询问openclaw让它自我修改配置重启网关即可# 将对话中的域名修改为您cpolar穿透保留后对应的公网域名地址请你修改一下openclaw的配置文件中allowedOrigins项原来的允许的域名【https://1cf1b8b8.r1.cpolar.top】修改为【https://openclaw.cpolar.top】改完后并重启openclaw网关接下来只需要和前面一样填写【网关令牌】然后授权一下设备就可以正常的使用固定后的二级子域名进行正常的对话啦好了现在即使你每天带着这台“赛博助理”走南闯北也再也不用为频繁变更的公网地址发愁了只要记住这个专属的二级子域名你的全能私人助理就能做到全天候在线陪伴随时听候你的指令。总结整套方案跑下来Windows平台的体验优势在于生态成熟、操作习惯一致不用折腾虚拟机或者额外装机。OpenClaw本身的能力边界取决于你给它接入什么模型和工具集可玩空间不小。有一点需要注意OpenClaw拥有系统级文件读写和鼠标键盘控制权限接入公网后务必妥善保管网关Token不要随意发到公开群里。之前提到的安全警告不是摆设——这台赛博打工人如果被陌生人拿到Token理论上可以对你的电脑为所欲为。固定二级子域名方案体验最稳定但建议配合强密码和Token管理一起用。如果你的需求是低门槛、快速跑起来、立刻能干活Windows一键部署这条路是最快的。23万Stars的项目经过了这么多人的验证踩坑成本相对低很多。