OpenClaw(小龙虾)Windows11保姆级安装教程
OpenClaw(国内用户俗称 “小龙虾”)是 2026 年爆火的开源本地 AI 自动化智能体,它可以帮你自动完成电脑上的重复操作:整理文件、批量归类、浏览器自动化、办公任务处理等,全程在本地运行,无需联网、无需云端账号,隐私安全有保障,堪称你的专属 AI 数字员工。
本教程专为 Windows 11 系统打造,覆盖新手一键部署和进阶手动安装两种方案,全程 step by step 讲解,帮你规避 99% 的安装坑,新手也能一次成功!
一、安装前必做准备(不做大概率失败!)
90% 的安装失败都源于这一步:OpenClaw 运行时需要模拟键鼠、读写文件、控制浏览器,这些操作会被安全软件误判为 “风险行为”,进而拦截、删除安装文件。请务必在安装前彻底关闭所有安全软件,安装完成后可重新开启!
1. 关闭第三方安全软件
请彻底关闭以下软件的所有进程:
-
360 系列:360 安全卫士、360 杀毒
-
腾讯系列:腾讯电脑管家
-
火绒安全(关闭实时防护功能)
2. 关闭 Windows 11 自带 Defender 实时防护
这是重中之重,必须操作:
-
打开 Windows 设置(快捷键
Win+I) -
点击「隐私和安全性」→ 选择「Windows 安全中心」
-
点击「病毒和威胁防护」→ 找到「管理设置」
-
关闭「实时保护」的开关,确认弹窗即可

二、新手推荐:一键部署方案(零代码・全自动)
这个方案是专为 Windows 11 优化的一键包,内置所有运行依赖,无需你手动装环境、敲命令,双击就能自动完成所有部署,小白首选!
步骤 1:下载 Win11 专属一键部署包
本次教程对应最新稳定版 2.6.2,下载链接:
官方高速下载:OpenClaw Win11 一键部署包 文件大小:约 361MB,下载后得到
.zip格式压缩包
步骤 2:正确解压压缩包(避坑重点!)
⚠️ 不要用 Windows 11 自带的解压工具! 它经常出现文件丢失、权限不足的问题,直接导致安装失败。 请使用专业解压工具:WinRAR 或 7-Zip(均为免费软件,网上可直接下载)
解压步骤:
-
找到下载好的压缩包,右键点击它
-
选择「解压到当前文件夹」
-
解压完成后,会得到
Openclaw-win文件夹 -
校验:打开文件夹,确认里面有
Openclaw Windows一键启动.exe(红色龙虾图标),如果找不到说明解压失败,重新关闭安全软件后再解压。
步骤 3:放行系统拦截,启动安装程序
Windows 11 会默认拦截未签名的开源程序,弹出拦截提示,这是正常现象,按以下步骤放行:
-
双击
Openclaw Windows一键启动.exe -
系统弹出「Windows 已保护你的电脑」提示窗口
-
点击窗口左下角的 【更多信息】点击新出现的 【仍要运行】,即可启动安装程序

步骤 4:设置安装路径(核心关键!)
进入安装欢迎界面后,点击红色的「开始使用」按钮,进入路径设置环节:
⚠️ 安装路径必须是纯英文路径,禁止包含中文、空格、特殊符号(如 @、#、&),否则 100% 报错!
✅ 推荐路径(优先选):
-
D:\OpenClaw(简单易记,不占 C 盘空间) -
E:\AI\OpenClaw(适合分类存放软件的用户)
❌ 绝对禁止的路径(必报错):
-
D:\软件\OpenClaw(包含中文) -
D:\小龙虾(包含中文,和软件昵称无关!)C:\Program Files\OpenClaw(路径包含空格,触发权限问题)
步骤 5:等待全自动安装
设置好路径后,点击「开始安装」,接下来你什么都不用做,程序会自动完成:
-
系统环境检测
-
运行依赖自动安装
-
核心服务部署
-
系统权限配置
-
桌面快捷方式创建
整个过程需要 3-5 分钟,期间不要关闭安装窗口,耐心等待即可。
步骤 6:启动验证,确认安装成功
安装完成后,程序会自动打开 OpenClaw 主界面,你只需要看右上角的状态:
-
如果显示 「Gateway 在线」,说明部署成功,可以正常使用了!
-
如果显示离线,参考文末的常见问题排查即可。
三、进阶用户:手动命令行安装方案
如果你是有基础的用户,想要手动部署,可以用这个方案,适合需要自定义配置的场景。
步骤 1:安装基础依赖
OpenClaw 依赖 Git 和 Node.js,先安装这两个工具:
-
安装 Git: 下载地址:Git-2.52.0-64-bit.exe 安装要点:全程默认下一步,无需修改配置。
-
安装 Node.js: 下载地址:Node.js 官网 安装要点:选择LTS 稳定版,且版本必须≥22,默认安装即可,自动配置环境变量。
-
验证环境: 以管理员身份打开 CMD,输入以下命令,出现版本号说明环境正常:
git --version node -v npm -v
步骤 2:安装 OpenClaw 核心程序
-
以管理员身份打开 CMD(右键开始菜单→Windows 终端 (管理员))
-
执行安装命令,国内用户推荐用淘宝镜像加速:
npm i -g openclaw --ignore-scripts --registry=https://registry.npmmirror.com如果遇到脚本执行权限报错,先执行这个命令:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force -
验证安装:输入
openclaw --version,出现版本号说明安装成功。
步骤 3:初始化配置与启动
-
执行初始化命令:
openclaw onboard --install-daemon -
按照向导配置:
-
协议确认:选
Yes -
安装模式:选
QuickStart -
模型选择:新手推荐
Qwen(通义千问)或Moonshot AI(Kimi) -
输入对应平台的 API Key(如果没有可以后续配置)
-
其余选项全部选
Skip for now即可
-
-
配置完成后,选择
Open the Web UI,浏览器会自动打开本地面板:http://127.0.0.1:18789/chat,即可开始使用。
四、快速上手:3 个指令马上体验
安装完成后,你可以直接在输入框输入自然语言指令,AI 会自动执行,推荐几个常用指令试试:
-
整理D盘下载文件夹内的所有图片,按格式分类存放 -
打开浏览器,搜索“2026 AI智能体发展趋势”,把找到的相关表格保存到桌面 -
批量归类桌面所有文件,按文档、图片、安装包分类 -
检查电脑里的垃圾文件,帮我清理掉(不删除重要文件)
五、常见问题排查(收藏备用)
|
问题 |
解决方法 |
|
安装时提示 “权限不足” |
右键点击安装程序,选择「以管理员身份运行」,重新启动安装 |
|
主界面 Gateway 一直显示离线 |
1. 确认 Defender 实时防护已关闭;2. 检查安装路径是否为纯英文;3. 重启 OpenClaw 程序 |
|
首次启动特别慢,长时间无响应 |
Win11 首次启动需要初始化系统环境,等待 1-3 分钟属于正常现象,后续启动会变快 |
|
AI 无法控制鼠标、无法读写文件 |
关闭 OpenClaw,右键桌面快捷方式,选择「以管理员身份运行」,重新启动即可 |
|
安装文件被杀毒软件删除,找不到启动程序 |
彻底关闭所有安全软件,重新下载压缩包、重新解压安装,避免再次被拦截 |
|
手动安装时报错 code 128 |
重试安装命令,检查网络是否正常,确认 Git 已经正确安装 |
六、后续注意事项
-
安装完成后,你可以重新开启之前关闭的安全软件和 Defender 实时防护,不会影响正常使用。
-
如果需要更新版本,重新下载最新的一键包,覆盖安装即可,配置会自动保留。
-
如果需要卸载,直接删除安装文件夹,然后删除桌面快捷方式即可,没有残留文件。
AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念,把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起,为开发者提供从开发、训练到部署的一站式体验。
更多推荐



所有评论(0)