OpenClaw 部署踩坑总结一键包完成本地 AI 自动化代理搭建适配系统Windows10/11 64 位、MacOS Windows 当前版本v2.9.3 MacOS 当前版本v2.7.9很多朋友在接触 OpenClaw 的时候会被环境依赖、组件安装等问题卡住。该一键安装包把 Python、Node.js 等各类依赖全部封装在内整套流程全部图形化操作不用敲任何命令普通用户也可以完成部署。Windows 安装包文件大小约 45.8MB建议优先选用浏览器自带下载工具或者迅雷下载避免下载中断损坏压缩包。Windows 端 v2.9.3 一键部署包https://xiake.yun/api/download/package/22?promoCodeIV4E9B04A80CMacOS 端 v2.7.9 一键部署包https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C⚠️极易踩坑的前置操作在解压、运行程序之前务必把电脑所有安全防护软件全部关闭包含 360 安全卫士、腾讯电脑管家、火绒同时关闭 Windows Defender 实时防护。OpenClaw 具备文件读写、键鼠模拟等系统自动化能力会被安全工具误判核心文件一旦被隔离删除部署直接失败。项目属于开源项目可前往 GitHub 核验安全情况关闭防护软件后再进行后续操作。第一步解压压缩包启动安装程序建议使用 WinRAR、7‑Zip 解压系统自带解压工具容易造成文件缺失损坏。右键压缩包选择解压到当前文件夹得到Openclaw‑win文件夹。进入解压目录双击Openclaw Windows 一键启动.exe红色龙虾图标方便识别。遇到 Windows SmartScreen 安全拦截弹窗点击更多信息 → 仍要运行。进入欢迎界面点击底部「开始使用」跳转到安装路径选择页面。重点注意安装路径规则 安装路径只能纯英文不能包含中文、空格、特殊符号不建议安装在 C 盘防止占用系统盘空间。 ✅推荐路径D:\OpenClaw、E:\AI\OpenClaw❌错误路径D:\AI工具\OpenClaw、D:\大龙虾项目勾选用户协议与免责声明点击开始安装进入自动部署流程。第二步全自动部署等待程序完成组件配置点击开始安装后全程不需要人为干预整个过程耗时 3‑5 分钟取决于电脑硬件性能。部署期间不要关闭窗口中断会直接造成部署失败。程序自动完成下面这些工作检测本机运行环境自动补齐 Git、Node.js、Python 等缺失依赖部署 Windows 平台对应的 OpenClaw 核心文件安装浏览器控制组件、键鼠模拟工具支撑自动化任务执行生成设备专属.env 配置文件完成注册并生成桌面快捷启动方式进度 100% 之后软件会自动弹出主程序界面。第三步第一次启动确认 Gateway 服务正常安装完毕自动进入初始化页面提示正在等待 Gateway 就绪...。第一次启动后台服务需要初始化等待 1‑3 分钟属于正常现象后续打开软件几秒就可以完成加载。当右上角状态显示Gateway 在线代表部署全部完成。界面各模块作用右上角Gateway 运行状态、重启按钮、日志入口、可用 Tokens 额度内置 28.00 万额度可体验基础能力左侧栏本地、渠道切换新建对话、查看历史会话中间区域对话窗口内置 AI 智能助手支持多模型切换代码片段自动高亮底部输入区自然语言指令输入Enter 发送ShiftEnter 换行支持自动、普通模式切换第四步下发自然语言指令测试自动化能力部署结束无需额外调参直接在底部输入框输入指令即可。OpenClaw 会自动拆解任务调用工具操控电脑完成操作指令描述越具体执行效果越好。测试指令直接复制使用将 D 盘下载文件夹按照文件类型新建文件夹完成分类整理打开记事本写入 “OpenClaw 部署完成”保存文件至桌面获取本机各个磁盘剩余空间整理成文字输出高频故障以及处理方案安装失败、点击启动毫无反应确认全部安全防护软件关闭关闭防护依旧异常删除旧解压文件重新解压安装包重试。Gateway 一直离线确认安装路径全部为英文无中文与特殊符号点击右上角重启按钮重启 Gateway 后台服务完全关闭程序右键选择以管理员身份运行提示网络错误第一次初始化需要网络保证网络通畅关闭代理、VPN 工具之后重启软件。Tokens 额度不足内置额度可以满足基础场景使用额度耗尽后在界面充值补充不会影响基础自动化功能。无法输入发送指令无反馈等待 Gateway 显示在线再下发指令如果依旧异常重新执行安装。日常使用的实用经验优先选择磁盘剩余空间大于 5G 的分区安装预留空间存放模型缓存和后续扩展组件。桌面快捷方式生成完成后后续直接双击快捷图标启动不用重复解压。需要对接飞书、微信等聊天渠道部署完成后前往设置‑聊天渠道板块配置就可以通过聊天窗口下发任务。更新版本直接下载新版安装包覆盖原文件夹即可不需要卸载旧版本。安装包下载地址Windows 端 v2.9.3 一键部署包https://xiake.yun/api/download/package/22?promoCodeIV4E9B04A80CMacOS 端 v2.7.9 一键部署包https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C
踩过这些坑之后，总结一份 OpenClaw 完整安装指南（含安装包）
OpenClaw 部署踩坑总结一键包完成本地 AI 自动化代理搭建适配系统Windows10/11 64 位、MacOS Windows 当前版本v2.9.3 MacOS 当前版本v2.7.9很多朋友在接触 OpenClaw 的时候会被环境依赖、组件安装等问题卡住。该一键安装包把 Python、Node.js 等各类依赖全部封装在内整套流程全部图形化操作不用敲任何命令普通用户也可以完成部署。Windows 安装包文件大小约 45.8MB建议优先选用浏览器自带下载工具或者迅雷下载避免下载中断损坏压缩包。Windows 端 v2.9.3 一键部署包https://xiake.yun/api/download/package/22?promoCodeIV4E9B04A80CMacOS 端 v2.7.9 一键部署包https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C⚠️极易踩坑的前置操作在解压、运行程序之前务必把电脑所有安全防护软件全部关闭包含 360 安全卫士、腾讯电脑管家、火绒同时关闭 Windows Defender 实时防护。OpenClaw 具备文件读写、键鼠模拟等系统自动化能力会被安全工具误判核心文件一旦被隔离删除部署直接失败。项目属于开源项目可前往 GitHub 核验安全情况关闭防护软件后再进行后续操作。第一步解压压缩包启动安装程序建议使用 WinRAR、7‑Zip 解压系统自带解压工具容易造成文件缺失损坏。右键压缩包选择解压到当前文件夹得到Openclaw‑win文件夹。进入解压目录双击Openclaw Windows 一键启动.exe红色龙虾图标方便识别。遇到 Windows SmartScreen 安全拦截弹窗点击更多信息 → 仍要运行。进入欢迎界面点击底部「开始使用」跳转到安装路径选择页面。重点注意安装路径规则 安装路径只能纯英文不能包含中文、空格、特殊符号不建议安装在 C 盘防止占用系统盘空间。 ✅推荐路径D:\OpenClaw、E:\AI\OpenClaw❌错误路径D:\AI工具\OpenClaw、D:\大龙虾项目勾选用户协议与免责声明点击开始安装进入自动部署流程。第二步全自动部署等待程序完成组件配置点击开始安装后全程不需要人为干预整个过程耗时 3‑5 分钟取决于电脑硬件性能。部署期间不要关闭窗口中断会直接造成部署失败。程序自动完成下面这些工作检测本机运行环境自动补齐 Git、Node.js、Python 等缺失依赖部署 Windows 平台对应的 OpenClaw 核心文件安装浏览器控制组件、键鼠模拟工具支撑自动化任务执行生成设备专属.env 配置文件完成注册并生成桌面快捷启动方式进度 100% 之后软件会自动弹出主程序界面。第三步第一次启动确认 Gateway 服务正常安装完毕自动进入初始化页面提示正在等待 Gateway 就绪...。第一次启动后台服务需要初始化等待 1‑3 分钟属于正常现象后续打开软件几秒就可以完成加载。当右上角状态显示Gateway 在线代表部署全部完成。界面各模块作用右上角Gateway 运行状态、重启按钮、日志入口、可用 Tokens 额度内置 28.00 万额度可体验基础能力左侧栏本地、渠道切换新建对话、查看历史会话中间区域对话窗口内置 AI 智能助手支持多模型切换代码片段自动高亮底部输入区自然语言指令输入Enter 发送ShiftEnter 换行支持自动、普通模式切换第四步下发自然语言指令测试自动化能力部署结束无需额外调参直接在底部输入框输入指令即可。OpenClaw 会自动拆解任务调用工具操控电脑完成操作指令描述越具体执行效果越好。测试指令直接复制使用将 D 盘下载文件夹按照文件类型新建文件夹完成分类整理打开记事本写入 “OpenClaw 部署完成”保存文件至桌面获取本机各个磁盘剩余空间整理成文字输出高频故障以及处理方案安装失败、点击启动毫无反应确认全部安全防护软件关闭关闭防护依旧异常删除旧解压文件重新解压安装包重试。Gateway 一直离线确认安装路径全部为英文无中文与特殊符号点击右上角重启按钮重启 Gateway 后台服务完全关闭程序右键选择以管理员身份运行提示网络错误第一次初始化需要网络保证网络通畅关闭代理、VPN 工具之后重启软件。Tokens 额度不足内置额度可以满足基础场景使用额度耗尽后在界面充值补充不会影响基础自动化功能。无法输入发送指令无反馈等待 Gateway 显示在线再下发指令如果依旧异常重新执行安装。日常使用的实用经验优先选择磁盘剩余空间大于 5G 的分区安装预留空间存放模型缓存和后续扩展组件。桌面快捷方式生成完成后后续直接双击快捷图标启动不用重复解压。需要对接飞书、微信等聊天渠道部署完成后前往设置‑聊天渠道板块配置就可以通过聊天窗口下发任务。更新版本直接下载新版安装包覆盖原文件夹即可不需要卸载旧版本。安装包下载地址Windows 端 v2.9.3 一键部署包https://xiake.yun/api/download/package/22?promoCodeIV4E9B04A80CMacOS 端 v2.7.9 一键部署包https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C