手把手教你在Windows上安装OpenClaw（2026最新版，零基础可上手）

大家好 最近OpenClaw俗称“龙虾助手”爆火作为一款开源轻量级AI自动化框架它能实现系统级控制、视觉理解、多端远程控制等功能无论是日常办公自动化还是辅助完成重复工作都特别实用。很多Windows用户反馈“不会安装”“踩坑无数”今天就出一篇保姆级教程从前置准备到安装完成、验证启动每一步都配详细操作零基础也能一次成功全程5-10分钟搞定先说明本文适配Windows 10 21H264位、Windows 11全版本两种安装方式可选——新手优先“一键脚本安装”自动配置环境无需手动操作进阶用户可选择“源码安装”灵活可控适合自定义配置大家根据自身情况选择即可。一、前置准备必做避免安装失败1.1 检查系统配置满足最低要求即可OpenClaw对Windows配置要求不高提前检查以下项避免白费功夫操作系统Windows 10 21H264位、Windows 11推荐兼容性更好运行内存最低8GB推荐16GB避免运行卡顿存储空间至少5GB可用空间安装包依赖约占500MB预留后续扩展空间账户权限必须拥有管理员权限安装脚本和服务启动需要检查方法按下WinR输入“winver”回车即可查看系统版本右键“此电脑”→“属性”可查看内存和系统位数。1.2 关闭安全软件临时安装后可恢复Windows Defender、360、腾讯电脑管家等安全软件可能会拦截OpenClaw的安装脚本和依赖下载导致安装失败。建议安装期间临时关闭安装完成后再重新开启放心OpenClaw是开源免费软件无捆绑、无恶意程序。1.3 准备终端PowerShell系统自带本次安装全程使用Windows自带的PowerShell无需额外下载其他终端操作如下按下WinX在弹出的菜单中选择“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向导后续配置模型需要。步骤3Onboarding向导配置核心让OpenClaw“活起来”安装完成后会自动启动Onboarding配置向导这一步是配置AI模型让OpenClaw拥有“思考能力”全程跟着提示走新手也能轻松完成具体步骤如下首次启动向导会提示“是否确认继续”选择“Yes”并回车键盘方向键可切换选项选择配置模式推荐新手选“QuickStart快速开始”回车确认选择AI模型优先选“Moonshot AIKimi 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安装前置工具GitNode.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个最常见的坑附上具体解决方案遇到问题直接对照解决坑1PowerShell执行脚本提示“权限不足”症状输入安装脚本后提示“无法加载脚本因为运行脚本被禁用”解决方案重新执行“步骤1开启PowerShell脚本执行权限”确保输入命令正确且以管理员身份打开PowerShell。坑2安装脚本下载超时、依赖失败症状安装过程中卡住提示“network request failed”解决方案检查网络确保网络通畅可切换手机热点尝试若使用一键安装失败切换为源码安装配置国内镜像后再尝试清除npm缓存输入命令npm cache clean --force回车后重新安装。坑3Onboarding向导卡住、无响应症状配置向导时按键盘方向键无反应或卡在某一步不动原因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自动化玩法