Windows 部署 OpenClaw 完整教程｜本地 AI 智能体 5 分钟落地，环境配置一次搞定
版本说明：Windows 3.1.0 / Mac 2.7.9
写在前面
近两年开源 AI 领域有一款被称作「数字员工」的工具持续走热，它就是 OpenClaw，圈内人更习惯叫它小龙虾。GitHub 上 28 万 + 的星标量，足以说明开发者对它的认可。它的核心卖点集中在三个方面：完全本地化运行、不需要写代码、能够自动完成电脑操作。不少人刚接触时以为它只是又一个聊天机器人，实际用过才发现，它是一套能听懂人话、自己拆解任务、主动调用工具干活的自动化系统。
这篇教程面向 CSDN 的技术读者，也照顾到完全没有基础的新手。整篇内容围绕最新版本整理，使用整合好的部署包，全程不需要敲命令，也不用自己折腾 Python 和 Node.js 环境，跟着步骤走很快就能跑起来。装好之后，文件归类、表格处理、数据抓取、邮件发送这类重复活儿，都可以交给它处理。
后面还会陆续更新技能插件扩展、本地大模型对接、微信飞书打通等进阶内容，感兴趣的可以持续关注。
一、OpenClaw 为什么值得装：核心能力盘点
这款工具能在众多开源 AI 项目中跑出来，根本原因是它切中了普通用户用 AI 智能体时的几个痛点：上手太难、数据不放心、功能华而不实。下面逐条说清楚它的特点：
✅数据全部留在本地：运行过程中产生的数据都存在自己电脑上，不需要上传到外部服务器，处理敏感文件时更安心；
✅不要求编程基础：整个安装和使用流程都是图形化界面，不用记命令，不用改配置文件，点几下鼠标就能完成；
✅多系统多渠道适配：Windows、Mac、Linux 都能跑，还能对接微信、飞书、Slack 这些常用沟通工具，人在外面也能远程派活；
✅依赖全部打包在内：部署包里已经把运行需要的环境和基础技能都装好了，解压就能用，不用自己一个个找依赖装；
✅办公场景覆盖广：整理下载文件夹、批量处理文档、自动填表、浏览器爬虫、数据汇总，日常办公里的重复操作基本都能覆盖。
二、装之前先做好这几件事，能避开 90% 的报错
很多人装到一半出问题，不是工具本身有 bug，而是前置条件没处理好。下面这几项务必在开始安装前全部确认到位。
第一件：把安全软件全关掉包括 360 安全卫士、腾讯电脑管家、火绒，还有 Windows 自带的 Defender 实时防护，不光要退主程序，后台进程也要确认结束掉。
为什么必须关？因为 OpenClaw 的工作原理就是模拟人操作电脑 —— 读写文件、控制浏览器、模拟键盘鼠标，这些行为在安全软件看来很像恶意程序，很容易被直接隔离或者删掉核心文件，导致装到一半失败。
补充一句：项目是完全开源的，代码都在 GitHub 上可以自己审查，关安全软件只是为了防止误杀，不是因为程序本身有问题。
三、第一步：拿到部署包并正确解压
1. 下载对应版本的安装包
Windows 3.1.0 版本下载链接： https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C
Mac 2.7.9 版本下载链接： https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
Windows 安装包体积约 45.8MB，用浏览器自带下载功能或者迅雷都可以，下完之后确认压缩包完整，不要出现下载中断导致的文件损坏。
2. 解压这一步别偷懒，用对工具很重要
❌ 别用 Windows 右键自带的「解压到当前文件夹」，实测容易出文件损坏和权限问题； ✅ 建议装个 WinRAR 或者 7-Zip，都是常用工具，官网就能下到。
具体解压流程：
- 找到刚下载好的压缩包；
- 右键选择用 WinRAR 或 7-Zip 打开；
- 选择解压到当前目录，或者指定一个文件夹，等 1 到 2 分钟解压完成；
- 解压完会出现一个 Openclaw-win 文件夹，点进去能看到一个红色龙虾图标的
Openclaw Windows 一键启动.exe，说明解压没问题。
四、第二步：运行启动程序，处理系统弹窗拦截
- 进入刚才解压出来的 Openclaw-win 文件夹，找到那个红色龙虾图标的启动程序。
- 双击运行，处理 Windows 的 SmartScreen 提示 有些电脑双击之后会弹出一个蓝色窗口，写着「Windows 已保护你的电脑」。这是 Windows 的正常安全机制，不是说这个程序有毒，按下面两步放行就行：
- 点窗口左下角的更多信息；
- 展开之后点仍要运行，程序就正常启动了。
如果你电脑没弹这个窗口，直接往下走就行。
五、第三步：自动部署，等着就行不用动手
1. 欢迎界面点开始
启动程序之后会弹出 OpenClaw 的欢迎页，红色龙虾 logo 很显眼，直接点底部的开始使用按钮，进入安装配置界面。
2. 安装路径一定要设对，这步错了必失败
路径有一个硬性要求：必须全英文，不能有中文、空格、特殊符号，不符合的话安装直接报错终止。
几个实用建议：
- 别装 C 盘，省得占系统盘空间，拖慢电脑；
- 推荐直接建
D:\OpenClaw，好记又符合要求； - 反面例子：
D:\软件\OpenClaw（有中文）、D:\小龙虾（中文命名）、D:\Open Claw（中间有空格），这些都不行。
路径选好之后，勾上「我已阅读并同意《用户协议》和《免责声明》」，点开始安装。
3. 安装过程别关窗口，3 到 5 分钟自动跑完
点了开始安装之后，剩下的事程序自己处理，一般 3 到 5 分钟搞定，具体看电脑配置。千万别中途关窗口，关了就得从头再来。
程序自动做的事情包括：
- 检查电脑环境，缺什么依赖（Git、Node.js、Python 这些）自动补；
- 把 OpenClaw 核心文件部署到指定目录；
- 装浏览器自动化控制组件；
- 生成适配你电脑的配置文件.env；
- 写注册表信息，在桌面创建快捷方式。
4. 第一次启动慢是正常的，别着急
装完之后程序会自动打开 OpenClaw 主界面。第一次启动的时候 Gateway 服务要初始化，界面上会显示「正在等待 Gateway 就绪...」，等个 1 到 3 分钟就进去了。后面再启动就是几秒钟的事，界面会自动跳到聊天窗口。
六、第四步：开始用你的 AI 数字员工，附现成指令
1. 怎么确认装成功了
进到主界面之后，看右上角，如果显示Gateway 在线，就说明服务跑起来了，整个部署流程圆满完成。
2. 界面各区域是干什么的
- 右上角：Gateway 状态指示、重启服务按钮、日志入口、剩余 Tokens 显示；
- 左边栏：切换「本地」和「渠道」两个分类，还能看历史对话；
- 底部输入框：直接打字发指令，Enter 发送，Shift+Enter 换行；
- 模式切换：默认就是自动模式，普通用户不用动。
3. 几条可以直接复制用的指令
指令写得越具体，AI 干得越到位。下面这几条是高频场景，直接粘进去就能测试效果：
- 帮我把 D 盘下载文件夹里的图片按拍摄日期分类，每个日期建一个文件夹放进去；
- 打开浏览器搜一下 2026 年 AI 行业发展趋势，把关键数据整理成 Excel 存到桌面；
- 打开微信，给备注叫 "同事 A" 的人发消息：本周工作总结已经发你邮箱了，麻烦查收；
- 把桌面上所有 Word 文档扫一遍，提取每篇的标题和核心要点，汇总成表格存到 D 盘。
七、高频问题排查手册
把大家装和用的过程中最容易碰到的几个问题整理在这里，出了问题先翻这部分。
Q1：安全软件把文件删了，启动不了怎么办A：先把所有安全软件彻底退出（包括后台进程），然后去安全软件的隔离区把 Openclaw-win 里被隔离的文件恢复出来，最后重新解压一遍压缩包，再运行启动程序。
Q2：安装时提示路径有中文或特殊字符，装不下去A：把安装路径改成纯英文的，去掉中文、空格和特殊符号。比如D:\软件\OpenClaw改成D:\OpenClaw，改完重新点开始安装。
Q3：Gateway 一直显示离线，发不了指令A：按顺序排查：
- 确认安全软件全关了，安装路径是纯英文；
- 点右上角的重启按钮，把 Gateway 服务重启一下；
- 还不行就完全退出 OpenClaw，重新跑一遍一键启动程序。
Q4：第一次启动一直转圈加载A：正常现象。第一次启动要初始化一堆依赖文件，等 1 到 3 分钟都在合理范围内，后面再开就快了，不用反复点。
八、后面还会更新这些内容
装好 OpenClaw 只是第一步，后面还有很多玩法可以挖。接下来会陆续出这些教程：
- 技能扩展：怎么加 PDF 转 Word、批量发邮件、自定义脚本这些能力；
- 本地大模型接入：不联网也能用，数据完全不出本机；
- 聊天工具联动：接微信、飞书、Slack，随时随地远程派活；
- 避坑大全：把各种报错、卡顿、离线的原因和解决办法汇总成一篇。
Windows 3.1.0 下载地址： https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C
Mac 2.7.9 下载地址： https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
安装过程中碰到其他问题，欢迎评论区留言，看到会回复。
