OpenClaw 排坑向教程｜Windows/macOS 本地 AI 智能体部署实录

基础信息

支持系统：Windows10/11 64 位、macOS 12 及以上 程序版本：Windows v2.9.0、macOS v2.7.9 安装包大小：45.8MB

很多使用者在部署 AI 自动化工具时，会卡在环境依赖、命令行操作等环节。OpenClaw 采用一体化封装方案，把 Git、Python、Node.js 等全套运行依赖打包进安装包，全部操作依靠图形界面完成，不需要敲写命令。本篇侧重实际部署过程中各类易错点，帮助大家避开各类问题，顺利完成部署。

Windows 安装包获取地址：https://xiake.yun/api/download/package/20?promoCode=IV4E9B04A80C

macOS 安装包获取地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IV4E9B04A80C

部署前关键注意事项

解压压缩包以及运行程序之前，务必关闭电脑全部安全防护软件，包含 360 安全卫士、腾讯电脑管家、火绒安全，同时关闭 Windows Defender 实时防护。

OpenClaw 具备读写本地文件、模拟键鼠、调度系统程序的能力，该类行为极易被安全软件判定为风险行为。一旦核心文件被隔离、删除，部署流程就会直接失败。项目属于开源项目，感兴趣的用户可以前往 GitHub 查看源码核验安全属性，关闭防护软件后再执行后续操作。

步骤一：获取对应系统安装压缩包

1. 根据本机操作系统，复制对应下载链接获取压缩包；
2. 将文件保存至桌面或者浏览器默认下载目录；
3. 下载建议使用浏览器自带下载工具或者迅雷，降低文件损坏、下载中断的概率。

步骤二：解压文件，规范设置安装路径

1. 优先使用 7‑Zip、WinRAR 解压，系统自带解压工具容易出现文件缺失损坏，右键压缩包选择解压到当前文件夹；
2. 打开解压完成的文件夹，双击龙虾图标对应的一键启动程序；
3. 遇到 Windows SmartScreen 拦截，点击更多信息，选择仍要运行；
4. 跳转欢迎界面，点击开始使用，进入安装路径选择页面。

⚠️重中之重：安装路径必须全部为英文字符，禁止中文、空格、特殊符号；不建议安装至 C 盘，防止占用系统盘存储空间 ✅推荐路径示例：D:\AITools\Agent\OpenClaw、E:\WorkTools\OpenClaw ❌错误路径示例：D:\AI工具\OpenClaw、D:\自动化软件

1. 勾选用户协议与免责声明，点击开始安装，进入自动部署流程。

步骤三：全自动部署，不要中断进程

点击开始安装后，程序自动完成整套部署工作，根据电脑硬件配置，耗时在 3‑5 分钟。部署运行期间，千万不要关闭窗口，关闭窗口会直接造成部署失败。

程序自动执行工作清单：

• 检测本机软硬件环境，补齐 Git、Node.js、Python 等运行依赖
• 拷贝项目核心程序文件，适配当前操作系统
• 部署浏览器驱动、键鼠模拟组件，支撑自动化任务执行
• 生成设备专属.env 配置文件，完成注册，生成桌面快捷启动图标

进度条达到 100%，程序会自动唤起 OpenClaw 主界面。

步骤四：第一次启动，确认 Gateway 服务状态

安装结束自动跳转初始化界面，页面提示「正在等待 Gateway 就绪...」。第一次启动需要完成后台服务初始化，等待 1‑3 分钟属于正常现象，后续再次打开加载速度会明显变快。

界面右上角显示「Gateway 在线」，代表部署成功。各功能区域简单说明：

• 右上角：Gateway 运行状态、重启按钮、日志查看入口、可用 Tokens 额度，内置 28 万额度，可满足基础功能体验
• 左侧面板：本地、渠道切换栏，可以新建对话，查看历史会话
• 中间窗口：AI 对话交互窗口，支持多模型切换，代码片段高亮渲染
• 底部输入框：录入自然语言指令，Enter 发送，Shift+Enter 换行，支持自动、普通两种执行模式

步骤五：下发指令，测试自动化执行效果

部署完成无需额外配置，直接在底部输入框输入自然语言指令。OpenClaw 会自动拆解任务，调用工具集完成电脑端操作。指令描述越细致，执行结果越符合预期。

新手测试指令，直接复制使用

1. 将 D 盘下载文件夹按照文件类型分类，新建对应文件夹归类全部文件
2. 打开记事本，写入文本 “OpenClaw 部署完成”，保存该文件到桌面
3. 统计电脑各个磁盘剩余存储空间，整理成文字输出结果

高频故障汇总与解决办法

安装失败、启动程序无响应

确认全部安全防护软件已经关闭；如果问题依旧，删除解压后的全部文件，重新解压压缩包再次执行安装。

Gateway 一直显示离线

1. 检查安装路径全部为英文，不存在中文、特殊符号；
2. 点击右上角重启按钮，重新拉起 Gateway 后台服务；
3. 完全关闭程序，右键启动程序，选择以管理员身份运行。

提示网络异常

第一次启动需要联网加载少量资源，保证网络通畅，关闭代理、VPN 工具之后重新启动程序。

Tokens 额度不足

内置 28 万额度可以覆盖大量基础自动化场景，额度耗尽后可以在界面充值补充，不会影响程序核心自动化能力。

输入框无法输入，发送指令没有反应

等待 Gateway 状态切换为在线之后再操作；问题持续出现，建议完整重装程序。

实际使用小提示

1. 安装磁盘建议预留 5G 以上空闲存储空间，存放后续技能插件、模型缓存；
2. 桌面快捷图标生成后，后续直接双击图标启动，不用重复解压安装包；
3. 需要对接飞书、微信聊天渠道下发指令，在主界面设置‑聊天渠道内完成配置；
4. 版本更新直接下载新版本压缩包覆盖原有文件夹，无需卸载旧版本。

工具能力简述

OpenClaw 支持 Windows、macOS 双平台，深度适配飞书生态，内置多款技能插件。任务全部本地运行，保障本地文件数据安全，覆盖文档撰写、表格处理、代码辅助、批量消息推送、多语言翻译等办公场景，处理各类重复机械工作。

部分内置技能

1. 飞书消息自动化：定时、批量推送群组通知，提升团队协作效率
2. 飞书多维表格处理：批量更新、导入导出表格数据，减少手工复制粘贴
3. AI 内容生成：产出报告、方案等各类业务文本
4. Excel 数据处理：完成数据清洗、格式转换，自动生成表格公式
5. 代码辅助：生成代码片段、解读代码逻辑，给出优化建议
6. 批量翻译：文档、文本多语言转换，适配跨团队协作场景

配套文档资源

官方配套文档覆盖各类使用场景：

• 快速上手文档：下载到部署完整流程讲解
• 飞书对接文档：飞书自动化相关配置教程
• 问题集合文档：汇总各类运行报错处理手段

安装包下载地址

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