OpenClaw 一键安装包|一键部署,告别复杂环境配置
适配系统:Windows10/11 64 位、macOS12+ Windows 版本:v3.1.0(虾壳云版) macOS 版本:v2.7.9
核心优势
整套流程全部采用可视化交互,不需要命令行操作,也不用手动部署 Python、Node.js 运行环境。安装包已经内置全部运行依赖,整套部署流程可以在 5 分钟内完成,即便是没有相关技术积累的使用者,也可以顺利完成搭建。
各系统安装包下载地址:
- 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 实时防护功能。
OpenClaw 具备系统操控、文件读写、键鼠模拟的能力,很容易被安全软件判定为风险程序,防护软件拦截或是删除程序内部文件,是安装失败的主要诱因。该项目为开源项目,使用者可以前往 GitHub 核验项目安全性,关闭防护软件后再执行后续操作。
第一步:获取对应系统安装包
访问对应下载链接获取安装压缩包,下载结束后,前往浏览器下载目录或者桌面找到对应压缩文件。
第二步:解压文件并启动程序,设置安装路径
推荐使用 WinRAR、7‑Zip 工具完成解压,系统自带解压工具容易造成文件损坏。右键压缩包,选择解压到当前文件夹,会生成对应的 Openclaw‑win 文件夹。
进入解压完成的文件夹,双击Openclaw Windows 一键启动.exe,文件带有红色龙虾标识,方便识别。如果系统弹出 Windows SmartScreen 安全拦截弹窗,点击更多信息 → 仍要运行即可继续。
程序启动后会进入欢迎界面,点击底部的「开始使用」,跳转至安装路径选择页面。
⚠️ 安装路径硬性要求:路径必须为纯英文,禁止出现中文、空格以及¥、& 等特殊符号。不建议安装在 C 盘,避免占用系统盘存储空间。
- 推荐示例路径:
D:\OpenClaw、E:\AI\OpenClaw- 错误示例路径:
D:\软件\OpenClaw、D:\小龙虾
勾选同意《用户协议》和《免责声明》,点击「开始安装」。
第三步:全自动部署,无需人为干预
点击开始安装后,软件会自动执行整套部署逻辑,使用者无需进行额外操作,整个过程大概 3‑5 分钟,具体耗时取决于电脑硬件配置。不要关闭安装窗口,否则会直接中断部署流程。
程序自动完成的工作包含:
- 检测本机运行环境,自动补齐 Git、Node.js、Python 等缺失依赖组件
- 在 Windows 系统下部署 OpenClaw 核心项目文件
- 部署浏览器控制组件、键鼠模拟工具,支撑自动化执行能力
- 生成本机专属
.env配置文件,完成初始化注册,同步创建桌面快捷方式
当安装进度走到 100%,程序会自动拉起 OpenClaw 主程序。
第四步:第一次启动,确认部署状态
安装结束后自动跳转到初始化页面,页面提示「正在等待 Gateway 就绪...」。第一次启动需要完成服务初始化,等待时长为 1‑3 分钟,后续启动仅需要数秒,该现象属于正常情况。
当页面右上角状态显示为Gateway 在线,就代表整套部署流程全部完成。主界面各区域功能说明:
- 右上角:Gateway 运行状态、服务重启、日志查看按钮,同时展示剩余 Tokens 额度,内置 28.00 万 Tokens 额度,可用于体验各项功能
- 左侧:「本地」「渠道」切换栏,可以新建对话,查看历史会话记录
- 中间:对话窗口,默认加载 AI 助手智能体,支持切换多模型,代码内容具备高亮效果
- 底部:自然语言指令输入框,Enter 发送消息,Shift+Enter 实现换行;支持切换自动、普通两种运行模式
第五步:下发指令体验工具能力
部署完成后,不用额外调整配置,直接在底部输入框输入自然语言指令,OpenClaw 就会解析任务,调用内置工具,驱动电脑完成对应操作。指令描述越具体,最终执行效果越理想。
新手可直接复制测试指令
帮我整理 D 盘下载文件夹,按文件类型分类创建文件夹 打开记事本,输入 “OpenClaw 部署成功”,保存到桌面 查询当前电脑的磁盘可用空间,整理成文字告诉我常见故障快速排查
安装失败 / 启动程序无响应
优先确认安全防护软件是否全部关闭;确认关闭后依旧异常,将压缩包重新解压一遍,再次执行安装流程。
Gateway 持续显示离线
- 确认安装路径为纯英文,不存在中文、特殊字符;
- 点击界面右上角重启按钮,重新拉起 Gateway 服务;
- 完全关闭程序,右键选择以管理员身份运行。
网络相关报错
第一次启动会消耗少量网络资源完成依赖初始化,请确认网络正常,关闭代理、VPN 之后重试。
Tokens 额度不足提示
内置 28 万 Tokens 足够完成基础功能体验,额度耗尽后,可在界面内进行充值,不会影响软件本身的核心运行。
界面无法输入、消息发送失效
等待 Gateway 完成初始化,状态变为在线之后再操作;依旧异常的情况下建议重新安装。
使用建议
- 建议选择磁盘剩余空间大于等于 5G 的盘符进行安装,预留空间用于后续技能插件扩展、模型缓存存储。
- 桌面快捷方式生成完毕后,后续直接双击快捷方式启动即可,不用重复解压安装包。
- 如果需要对接飞书、微信这类聊天渠道,部署完成后,前往主界面「设置」→「聊天渠道」完成配置,就可以通过聊天窗口下发任务指令。
- 版本更新时,直接下载最新安装包,覆盖原有文件夹,不需要卸载旧版本。
各系统安装包下载地址:
- 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
项目会持续迭代更新,后续会更新技能拓展、本地大模型接入、多渠道联动等实操教程,可以关注项目官方渠道获取更多内容。