手把手教你在Windows上安装OpenClaw(2026最新版,零基础可上手)
大家好~ 最近OpenClaw(俗称“龙虾助手”)爆火,作为一款开源轻量级AI自动化框架,它能实现系统级控制、视觉理解、多端远程控制等功能,无论是日常办公自动化,还是辅助完成重复工作,都特别实用。很多Windows用户反馈“不会安装”“踩坑无数”,今天就出一篇保姆级教程,从前置准备到安装完成、验证启动,每一步都配详细操作,零基础也能一次成功,全程5-10分钟搞定!
先说明:本文适配Windows 10 21H2+(64位)、Windows 11全版本,两种安装方式可选——新手优先“一键脚本安装”(自动配置环境,无需手动操作),进阶用户可选择“源码安装”(灵活可控,适合自定义配置),大家根据自身情况选择即可。
一、前置准备(必做!避免安装失败)
1.1 检查系统配置(满足最低要求即可)
OpenClaw对Windows配置要求不高,提前检查以下项,避免白费功夫:
操作系统:Windows 10 21H2+(64位)、Windows 11(推荐,兼容性更好)
运行内存:最低8GB(推荐16GB,避免运行卡顿)
存储空间:至少5GB可用空间(安装包+依赖约占500MB,预留后续扩展空间)
账户权限:必须拥有管理员权限(安装脚本和服务启动需要)
检查方法:按下Win+R,输入“winver”回车,即可查看系统版本;右键“此电脑”→“属性”,可查看内存和系统位数。
1.2 关闭安全软件(临时,安装后可恢复)
Windows Defender、360、腾讯电脑管家等安全软件,可能会拦截OpenClaw的安装脚本和依赖下载,导致安装失败。建议安装期间临时关闭,安装完成后再重新开启,放心,OpenClaw是开源免费软件,无捆绑、无恶意程序。
1.3 准备终端(PowerShell,系统自带)
本次安装全程使用Windows自带的PowerShell,无需额外下载其他终端,操作如下:
按下Win+X,在弹出的菜单中选择“Windows PowerShell(管理员)”(注意:必须选“管理员”,否则权限不足);
首次打开可能会提示“执行策略阻止”,后续步骤会解决,无需担心。
二、新手首选:一键脚本安装(最省心,5分钟搞定)
这是OpenClaw官方推荐的安装方式,脚本会自动检测系统环境、安装Node.js(必备依赖)、下载OpenClaw主程序,全程无需手动配置,适合零基础用户,步骤如下:
步骤1:开启PowerShell脚本执行权限(必做)
Windows默认禁止运行第三方脚本,不开启权限会导致安装脚本无法执行,操作如下:
在打开的“管理员PowerShell”中,输入以下命令,然后按下回车:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned此时会提示“是否更改执行策略”,输入“Y”(大小写均可),再次按下回车,权限即可开启(后续安装完成后,无需恢复,不影响系统安全)。
步骤2:执行一键安装脚本
权限开启后,直接在PowerShell中输入以下安装命令,按下回车即可开始自动安装:
iwr -useb https://openclaw.ai/install.ps1 | iex
⚠️ 注意:输入命令时,确保没有拼写错误(可直接复制粘贴);安装过程中会自动下载Node.js和OpenClaw依赖,网速越快,安装时间越短,耐心等待即可(期间不要关闭PowerShell,不要中断进程)。
安装过程中会出现两次确认提示,均输入“Y”并回车即可:一次是确认安装Node.js(若系统已安装,会自动跳过),一次是确认启动Onboarding向导(后续配置模型需要)。
步骤3:Onboarding向导配置(核心,让OpenClaw“活起来”)
安装完成后,会自动启动Onboarding配置向导,这一步是配置AI模型(让OpenClaw拥有“思考能力”),全程跟着提示走,新手也能轻松完成,具体步骤如下:
首次启动向导,会提示“是否确认继续”,选择“Yes”并回车(键盘方向键可切换选项);
选择配置模式:推荐新手选“QuickStart(快速开始)”,回车确认;
选择AI模型:优先选“Moonshot AI(Kimi K2.5)”或“DeepSeek”(适合国内用户,无需科学上网),回车确认;
配置API Key:这是关键步骤!需要先去对应AI平台获取API Key(以Moonshot为例):
打开浏览器,访问Moonshot官网:https://platform.moonshot.cn/console,登录账号(无账号可免费注册);
点击左侧“API Key管理”,创建一个新的API Key,复制生成的密钥(不要泄露给他人);
回到PowerShell,将复制的API Key粘贴进去,按下回车;
后续配置:聊天载体(可暂时跳过,后续再配置微信/飞书)、网络搜索提供商(选与模型对应的即可)、技能安装(选“Yes”,安装基础技能),其余选项可全部选“No”跳过;
配置完成后,会自动启动OpenClaw网关,弹出登录页面,说明向导配置成功。
步骤4:验证安装(确认是否成功)
安装和配置完成后,我们通过3个命令验证是否安装成功,在PowerShell中依次输入以下命令,按下回车:
openclaw --version:若输出版本号(如v2026.3.7),说明OpenClaw主程序安装成功;openclaw doctor:会自动检测系统环境、依赖、配置文件,若提示“All checks passed”,说明环境无问题;openclaw gateway status:若提示“Gateway is running”,说明网关启动成功,OpenClaw可正常使用。
三、进阶选项:源码安装(灵活可控,适合进阶用户)
如果新手一键安装失败,或你需要自定义配置OpenClaw(如修改源码、添加自定义技能),可选择源码安装,步骤如下(比一键安装多2步前置工具安装):
步骤1:安装前置工具(Git+Node.js)
安装Git:
访问Git官网下载:https://git-scm.com/download/win,选择64位安装包;
双击安装包,全程默认下一步即可(无需修改配置),安装完成后,右键桌面会出现“Git Bash Here”,说明安装成功。
安装Node.js:
访问Node.js官网下载:https://nodejs.org/zh-cn/download/,选择“长期支持版(LTS)”,下载Windows安装程序(.msi);
双击安装,勾选“Add Node.js to PATH”(自动配置环境变量),其余默认下一步,安装完成后,在PowerShell中输入“node --version”,输出版本号(v22.x.x)即可。
安装pnpm并配置国内镜像(加速依赖下载):
在PowerShell中输入命令:
npm install -g pnpm,回车安装;输入命令配置国内镜像:
pnpm config set registry https://registry.npmmirror.com/,回车确认(国内用户必做,避免依赖下载超时)。
步骤2:下载OpenClaw源码并安装
打开Git Bash(右键桌面→Git Bash Here),输入以下命令,下载源码(二选一即可):
原版源码(官方版):
git clone https://github.com/openclaw/openclaw.git中国社区版(适配国内环境,推荐):
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
进入源码目录:输入命令
cd openclaw(若下载的是社区版,输入cd openclaw-cn),回车;安装依赖:输入命令
pnpm install,回车,耐心等待依赖下载完成(期间不要中断);构建程序:依次输入以下两个命令,每个命令回车后等待完成:
pnpm ui:buildpnpm build
启动配置向导:输入命令
pnpm openclaw onboard --install-daemon,回车,后续配置步骤和“一键安装”的Onboarding向导一致(参考第二步步骤3)。
步骤3:验证源码安装成功
和一键安装的验证方法一致,在PowerShell中输入3个验证命令,均能正常输出版本、检测通过、网关运行,说明源码安装成功。
四、常见踩坑解决(新手必看!)
很多用户安装时会遇到各种问题,整理了4个最常见的坑,附上具体解决方案,遇到问题直接对照解决:
坑1:PowerShell执行脚本提示“权限不足”
症状:输入安装脚本后,提示“无法加载脚本,因为运行脚本被禁用”,解决方案:重新执行“步骤1:开启PowerShell脚本执行权限”,确保输入命令正确,且以管理员身份打开PowerShell。
坑2:安装脚本下载超时、依赖失败
症状:安装过程中卡住,提示“network request failed”,解决方案:
检查网络,确保网络通畅,可切换手机热点尝试;
若使用一键安装失败,切换为源码安装,配置国内镜像后再尝试;
清除npm缓存:输入命令
npm cache clean --force,回车后重新安装。
坑3:Onboarding向导卡住、无响应
症状:配置向导时,按键盘方向键无反应,或卡在某一步不动,原因:Git Bash的MinTTY终端与Node.js交互式菜单不兼容,解决方案:
关闭Git Bash,重新以管理员身份打开PowerShell;
进入OpenClaw源码目录(cd openclaw),重新执行命令
pnpm openclaw onboard --install-daemon,在PowerShell中完成配置即可。
坑4:验证时提示“openclaw不是内部或外部命令”
症状:输入openclaw --version后,提示命令不存在,解决方案:
检查Node.js环境变量是否配置成功:输入
npm prefix -g,查看全局包路径;将该路径添加到系统环境变量(此电脑→属性→高级系统设置→环境变量→Path→编辑→添加路径);
重启PowerShell,重新输入验证命令即可。
五、安装完成后,下一步做什么?
恭喜你!成功在Windows上安装了OpenClaw,接下来可以做3件事,快速解锁它的核心功能:
配置沟通渠道:接入微信、飞书等常用工具,后续可在这些工具中直接与OpenClaw对话;
安装实用技能:在OpenClaw界面中,安装文件处理、文档总结、日程安排等技能,适配日常办公需求;
尝试基础操作:输入命令
openclaw tui,进入终端聊天界面,测试AI对话、简单自动化操作。
总结
Windows安装OpenClaw,新手优先选“一键脚本安装”,省心高效,全程自动配置;进阶用户可选择“源码安装”,灵活自定义。只要按照教程步骤操作,避开常见坑,零基础也能一次安装成功。
如果安装过程中遇到其他问题,欢迎在评论区留言,我会第一时间回复解答~ 后续还会更新OpenClaw的实用技巧,关注我,解锁更多AI自动化玩法!
