AI 智能体 OpenClaw Windows+macOS 双平台部署实操-育师

OpenClaw 本地部署指南｜简化环境配置，快速搭建 AI 自动化工具

OpenClaw 可以实现电脑自动化操控，支持文件管理、键鼠模拟、浏览器控制等能力。传统搭建方式需要手动配置各类运行环境，门槛较高。本文整理 Windows 与 macOS 平台的完整部署流程，采用一体化安装包，借助可视化向导完成部署。

适配系统：Windows10/11 64 位、macOS 12 及以上当前版本：Windows v3.1.0；macOS v2.7.9

整套部署流程可视化操作，无需使用命令行工具，不用手动安装 Python、Node.js 等运行组件。全部依赖包已经打包内置，整套部署流程大约 5 分钟，零基础用户也能顺利完成环境搭建。

Windows3.1.0 版本下载地址：https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C

macOS2.7.9 版本下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

解压、安装、启动程序前，建议关闭电脑上所有安全防护程序，包括 360 安全卫士、腾讯电脑管家、火绒以及 Windows Defender 实时防护。

OpenClaw 具备系统操控、文件读写、键鼠模拟功能，容易被安全软件识别为风险程序。一旦核心文件被拦截删除，会直接导致部署失败。项目属于开源项目，安全性可前往 GitHub 进行核验，关闭防护软件之后再进行后续操作。

访问项目站点，找到下载入口，选择对应操作系统的压缩包进行获取。安装包文件大小约 45.8MB，推荐使用浏览器自带下载工具或者迅雷下载，降低文件中断损坏的概率。下载完成后，可以在浏览器下载目录或者桌面找到压缩包。

推荐使用 WinRAR、7-Zip 解压，系统自带解压工具容易出现解压不全、文件损坏问题。右键压缩包，选择解压到当前文件夹，生成程序目录。

进入解压后的文件夹，双击「Openclaw Windows 一键启动.exe」，红色龙虾图标便于识别。

如果 Windows SmartScreen 弹出拦截提示，点击更多信息 → 仍要运行。

进入欢迎界面后，点击底部红色「开始使用」，跳转安装路径选择页面。

⚠️重要规则：安装路径必须使用纯英文目录，路径不能包含中文、空格、￥、&、・等特殊字符。不建议安装到 C 盘，减少占用系统盘存储空间。推荐路径：D:\OpenClaw / E:\AI\OpenClaw 不推荐示例：D:\ 软件 \OpenClaw / D:\ 小龙虾

勾选同意《用户协议》与《免责声明》，点击开始安装。

点击开始安装，程序自动执行整套部署流程，耗时 3-5 分钟，具体时长取决于电脑硬件配置。请勿中途关闭安装窗口，否则部署任务直接中断。

程序自动执行任务清单：

进度条达到 100% 后，软件自动启动 OpenClaw 主程序。

安装结束自动进入初始化界面，页面提示「正在等待 Gateway 就绪...」。第一次启动需要初始化后台服务，等待 1-3 分钟属于正常现象；后续启动仅需要数秒。

主界面右上角显示Gateway 在线，代表部署顺利完成。界面分区说明：

部署完成后无需额外配置，直接在底部输入框输入自然语言指令。OpenClaw 会自动拆解任务，调用内置工具，操控电脑执行操作。指令描述越详细，任务执行效果越稳定。

帮我整理 D 盘下载文件夹，按文件类型分类创建文件夹 打开记事本，输入 “OpenClaw 部署成功”，保存到桌面 查询当前电脑的磁盘可用空间，整理成文字告诉我

安装失败、启动程序无响应：确认安全防护软件已经全部关闭；关闭防护后依旧报错，重新解压压缩包重试部署。
Gateway 持续离线：①确认安装路径全部为英文，不含中文与特殊字符；②点击右上角重启按钮，重启 Gateway 服务；③完全关闭程序，右键选择以管理员身份运行。
网络报错提示：第一次启动程序需要网络完成组件初始化，保证网络连通，关闭代理、VPN 工具重试。
Tokens 额度不足：内置 28 万额度可以体验基础功能，额度耗尽后，可在界面充值入口补充，不会影响软件核心功能。
界面无法输入、发送指令：等待 Gateway 状态切换至在线再操作；异常持续可重新部署程序。