OpenClaw 一键部署指南｜简化环境配置，快速搭建 AI 自动化工具

适配系统：Windows10/11 64 位、macOS 12+ 当前版本：Windows v3.1.0；macOS v2.7.9（虾壳云版）

核心优势：整套部署流程可视化呈现，无需敲写命令行，Python、Node.js 等运行环境无需手动配置，所有依赖组件已内置打包。整个部署流程耗时较短，零基础使用者也能够顺利完成搭建，借助工具实现电脑自动化任务处理。

Windows 下载地址：https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C

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

前置重要提醒（直接影响安装结果）

在解压安装包、执行安装以及启动程序前，需要关闭电脑上所有安全防护软件，包括 360 安全卫士、腾讯电脑管家、火绒以及 Windows Defender 实时防护。

OpenClaw 拥有系统操控、文件读写、键鼠模拟自动化能力，容易被安全软件判定为风险程序，一旦核心文件被隔离删除，安装流程就会失败。该项目属于开源项目，可前往 GitHub 查看源码核验安全情况。

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

压缩包文件大小约 45.8MB，推荐使用浏览器自带下载工具或者迅雷下载，防止下载中断造成压缩包损坏。下载完成后，可在浏览器下载目录或者桌面找到 zip 格式文件。

第二步：解压文件，启动程序并设置安装目录

推荐使用 WinRAR、7-Zip 工具解压，系统自带解压工具容易出现文件损坏问题。右键压缩包，选择解压到当前文件夹，生成程序文件夹。

打开解压后的文件夹，双击Openclaw Windows 一键启动.exe，文件带有龙虾图标，方便识别。如果弹出 Windows SmartScreen 拦截提示，依次点击更多信息 → 仍要运行即可继续。

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

⚠️ 安装路径必须为纯英文，不能包含中文、空格以及￥、& 这类特殊符号；不建议安装至 C 盘，避免占用系统盘空间。

推荐路径示例： D:\OpenClaw E:\AI\OpenClaw

不推荐路径示例： D:\软件\OpenClaw D:\小龙虾

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

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

点击开始安装后，程序自动执行全部部署任务，使用者无需额外操作。整个过程耗时 3‑5 分钟，具体时长取决于电脑硬件配置，安装期间不要关闭窗口，否则部署会直接中断。

自动化执行的任务清单：

1. 检测本机运行环境，自动补齐 Git、Node.js、Python 等缺失依赖；
2. 将 OpenClaw 核心项目文件部署到 Windows 系统；
3. 安装浏览器控制组件、键鼠模拟工具，支撑自动化操作；
4. 生成本机专属.env配置文件，完成注册并创建桌面快捷方式。

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

第四步：第一次启动，验证部署状态

安装完成自动跳转初始化界面，页面提示 “正在等待 Gateway 就绪...”。第一次启动需要完成服务初始化，等待 1‑3 分钟属于正常情况，后续再次启动仅需数秒。

当页面右上角状态显示 Gateway 在线，代表部署成功。主界面各区域功能说明：

• 右上角：Gateway 运行状态、重启与日志查看按钮、剩余 Tokens 额度，内置 28 万 Tokens 可供体验；
• 左侧面板：本地与渠道切换栏，支持新建对话、查看历史会话；
• 中间区域：对话窗口，搭载 AI 智能助手，支持切换多种模型，代码块自动高亮；
• 底部输入框：用于输入自然语言指令；Enter 发送消息，Shift+Enter 换行，可切换自动、普通两种运行模式。

第五步：输入 AI 指令，测试自动化功能

部署完成无需额外配置，直接在底部输入框输入自然语言指令。OpenClaw 会自动拆解任务，调用工具操控电脑执行操作；指令描述越细致，执行效果越稳定。

可复制下面测试指令快速验证功能：

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

常见问题快速排查

1. 安装失败，启动无响应：确认所有防护软件已关闭；关闭防护后依旧异常，则重新解压压缩包重试。
2. Gateway 持续离线
   • 确认安装路径全部为英文，不存在中文、特殊字符；
   • 点击右上角重启按钮，重新拉起 Gateway 服务；
   • 完全关闭程序，右键选择以管理员身份运行。
3. 提示网络错误：第一次初始化需要网络支持，保证网络连通，关闭代理、VPN 重试。
4. Tokens 额度不足提示：内置 28 万 Tokens 可体验基础能力，额度耗尽之后，可在界面充值补充，不会影响软件基础操作。
5. 输入框无法输入，消息发送失败：等待 Gateway 状态变为在线再操作；问题依旧可重新部署。

使用小贴士

1. 建议选择磁盘剩余空间≥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