当前位置: 首页 > news >正文

手把手教你在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,无需额外下载其他终端,操作如下:

  1. 按下Win+X,在弹出的菜单中选择“Windows PowerShell(管理员)”(注意:必须选“管理员”,否则权限不足);

  2. 首次打开可能会提示“执行策略阻止”,后续步骤会解决,无需担心。

二、新手首选:一键脚本安装(最省心,5分钟搞定)

这是OpenClaw官方推荐的安装方式,脚本会自动检测系统环境、安装Node.js(必备依赖)、下载OpenClaw主程序,全程无需手动配置,适合零基础用户,步骤如下:

步骤1:开启PowerShell脚本执行权限(必做)

Windows默认禁止运行第三方脚本,不开启权限会导致安装脚本无法执行,操作如下:

  1. 在打开的“管理员PowerShell”中,输入以下命令,然后按下回车:

  2. Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

  3. 此时会提示“是否更改执行策略”,输入“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拥有“思考能力”),全程跟着提示走,新手也能轻松完成,具体步骤如下:

  1. 首次启动向导,会提示“是否确认继续”,选择“Yes”并回车(键盘方向键可切换选项);

  2. 选择配置模式:推荐新手选“QuickStart(快速开始)”,回车确认;

  3. 选择AI模型:优先选“Moonshot AI(Kimi K2.5)”或“DeepSeek”(适合国内用户,无需科学上网),回车确认;

  4. 配置API Key:这是关键步骤!需要先去对应AI平台获取API Key(以Moonshot为例):

    1. 打开浏览器,访问Moonshot官网:https://platform.moonshot.cn/console,登录账号(无账号可免费注册);

    2. 点击左侧“API Key管理”,创建一个新的API Key,复制生成的密钥(不要泄露给他人);

    3. 回到PowerShell,将复制的API Key粘贴进去,按下回车;

  5. 后续配置:聊天载体(可暂时跳过,后续再配置微信/飞书)、网络搜索提供商(选与模型对应的即可)、技能安装(选“Yes”,安装基础技能),其余选项可全部选“No”跳过;

  6. 配置完成后,会自动启动OpenClaw网关,弹出登录页面,说明向导配置成功。

步骤4:验证安装(确认是否成功)

安装和配置完成后,我们通过3个命令验证是否安装成功,在PowerShell中依次输入以下命令,按下回车:

  1. openclaw --version:若输出版本号(如v2026.3.7),说明OpenClaw主程序安装成功;

  2. openclaw doctor:会自动检测系统环境、依赖、配置文件,若提示“All checks passed”,说明环境无问题;

  3. openclaw gateway status:若提示“Gateway is running”,说明网关启动成功,OpenClaw可正常使用。

三、进阶选项:源码安装(灵活可控,适合进阶用户)

如果新手一键安装失败,或你需要自定义配置OpenClaw(如修改源码、添加自定义技能),可选择源码安装,步骤如下(比一键安装多2步前置工具安装):

步骤1:安装前置工具(Git+Node.js)

  1. 安装Git:

    1. 访问Git官网下载:https://git-scm.com/download/win,选择64位安装包;

    2. 双击安装包,全程默认下一步即可(无需修改配置),安装完成后,右键桌面会出现“Git Bash Here”,说明安装成功。

  2. 安装Node.js:

    1. 访问Node.js官网下载:https://nodejs.org/zh-cn/download/,选择“长期支持版(LTS)”,下载Windows安装程序(.msi);

    2. 双击安装,勾选“Add Node.js to PATH”(自动配置环境变量),其余默认下一步,安装完成后,在PowerShell中输入“node --version”,输出版本号(v22.x.x)即可。

  3. 安装pnpm并配置国内镜像(加速依赖下载):

    1. 在PowerShell中输入命令:npm install -g pnpm,回车安装;

    2. 输入命令配置国内镜像:pnpm config set registry https://registry.npmmirror.com/,回车确认(国内用户必做,避免依赖下载超时)。

步骤2:下载OpenClaw源码并安装

  1. 打开Git Bash(右键桌面→Git Bash Here),输入以下命令,下载源码(二选一即可):

    1. 原版源码(官方版):git clone https://github.com/openclaw/openclaw.git

    2. 中国社区版(适配国内环境,推荐):git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git

  2. 进入源码目录:输入命令cd openclaw(若下载的是社区版,输入cd openclaw-cn),回车;

  3. 安装依赖:输入命令pnpm install,回车,耐心等待依赖下载完成(期间不要中断);

  4. 构建程序:依次输入以下两个命令,每个命令回车后等待完成:

    1. pnpm ui:build

    2. pnpm build

  5. 启动配置向导:输入命令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件事,快速解锁它的核心功能:

  1. 配置沟通渠道:接入微信、飞书等常用工具,后续可在这些工具中直接与OpenClaw对话;

  2. 安装实用技能:在OpenClaw界面中,安装文件处理、文档总结、日程安排等技能,适配日常办公需求;

  3. 尝试基础操作:输入命令openclaw tui,进入终端聊天界面,测试AI对话、简单自动化操作。

总结

Windows安装OpenClaw,新手优先选“一键脚本安装”,省心高效,全程自动配置;进阶用户可选择“源码安装”,灵活自定义。只要按照教程步骤操作,避开常见坑,零基础也能一次安装成功。

如果安装过程中遇到其他问题,欢迎在评论区留言,我会第一时间回复解答~ 后续还会更新OpenClaw的实用技巧,关注我,解锁更多AI自动化玩法!

http://www.cnnetsun.cn/news/1795530.html

相关文章:

  • 掌握CarouselLayoutManager水平与垂直布局:终极技巧
  • Vue使用Electron将网页打包为exe文件
  • ClearerVoice-Studio插件开发:为Audacity添加AI降噪功能
  • CosyVoice-300M Lite安装报错?解决tensorrt依赖问题完整指南
  • 深度学习项目训练环境生产环境:支持持续训练、断点续训、多卡DDP扩展
  • DeOldify模型部署成本分析:星图GPU平台不同配置下的性价比对比
  • 开源情报收集:OpenClaw调度SecGPT-14B自动化监控暗网
  • 突破信息壁垒:6个提升内容可访问性的创新方案
  • 【Luck-Report】条件属性
  • 字符设备注册和设备号
  • 抖音无人直播转播系统|多平台直播源解析+商品自动抓取|含全套软件与实操教程
  • Phi-3 Forest Laboratory C语言编程辅助:从基础语法到内存管理调试
  • lite-avatar形象库效果展示:150+预训练数字人形象作品集
  • 遇到一个口头机遇的答辩准备5(重新整理)
  • Kook Zimage 真实幻想 Turbo 结合Agent Skill开发:打造个性化AI创作助手
  • Starry Night艺术馆部署指南:Linux/Windows双平台环境适配步骤
  • Speech Seaco Paraformer热词功能详解:如何提升专业术语识别准确率
  • 4步部署Qwen2.5:网页服务接入实操手册
  • IRRemoteESP32深度解析:ESP32红外收发与协议解码实战
  • Omni-Vision Sanctuary跨平台部署实践:从x86到ARM架构的考量
  • LAYONTHEGROUND居
  • Spring_couplet_generation批量处理脚本编写:高效生成海量春联素材
  • S2-Pro智能运维应用:自动分析日志文件并定位系统故障
  • **发散创新:基于Python与TTS的语音合成系统实战解析**在人工智能快速发展的今天,**语音合成(Text-to-Spe
  • Spring Boot 入门:理解 IoC 容器与 Bean 管理(附图解)
  • Ostrakon-VL-8B GPU算力优化:Bfloat16 vs FP16显存占用与精度平衡分析
  • Omni-Vision Sanctuary 服务端部署:使用 Node.js 构建高性能图像生成 API 网关
  • Nomic-Embed-Text-V2-MoE工具链整合:在IDE中快速调试模型API调用代码
  • PCB设计中特殊元器件布局与热管理实战技巧
  • OpenClaw内存优化:在8GB设备运行Qwen3.5-9B-4bit方案