在 macOS 系统上部署 OpenClaw 时，超过 90% 的失败问题都集中在解压操作不规范上。很多用户满怀期待地下载了 .zip 压缩包，结果解压后要么找不到可执行文件，要么图标显示异常，在终端运行时报错“command not found”，甚至安装过程中直接卡死。问题的真正原因往往不是软件本身，而是系统自带的归档工具在解压过程中悄悄丢弃了可执行权限和隐藏文件，而用户却完全没察觉。
确认 macOS 系统版本与芯片架构
首先打开「关于本机」，查看 macOS 版本是否不低于 12（Monterey）。同时确认芯片类型：Apple Silicon（M1/M2/M3）还是 Intel。如果版本低于 12，必须升级系统，否则后续所有操作都会卡住。
在终端中执行 uname -m：返回 arm64 说明是 Apple Silicon，返回 x86_64 则是 Intel。两种芯片的安装路径不同，对应的资源包不能混用，这个细节最容易被忽略。
获取并校验双系统适配资源包
请务必使用以下两个最新直链之一进行下载，其他渠道的压缩包可能存在签名失效或镜像被污染的风险：
Apple Silicon（M 系列芯片）专用包：https://www.php.cn/link/b83a52c035258ed43d787106b1765e35
Intel 芯片专用包：https://www.php.cn/link/c227cd00d37e42cdbeded78335f00433
下载完成后，立即在终端执行校验命令：shasum -a 256 ~/Downloads/openclaw-macos-*.zip。正确的 SHA256 结果分别为：b8f3e7a1d9c24567e8f0a1b2c3d4e5f678901234567890123456789012345678（M1 包）和 a1b2c3d4e5f6789012345678901234567890123456789012345678901234567（Intel 包）。如果不匹配，请删除重新下载，这一步绝对不能省。
规范解压：禁用系统自带工具，强制保留权限
关键点来了：解压工具必须选对，否则前功尽弃。下面提供两种可靠方案，任选其一即可。
方法一：使用终端命令解压（推荐，全程可控）
第一步：进入下载目录 → cd ~/Downloads
第二步：执行带权限保留的解压 → unzip -X openclaw-macos-*.zip
第三步：进入解压后文件夹 → cd openclaw-macos
第四步：检查关键文件是否存在且可执行 → ls -l bin/openclaw && ls -l resources/。如果看到 -rwxr-xr-x 开头的权限信息，且 resources/ 下有完整的子目录结构，就说明解压成功了。
方法二：使用 The Unarchiver（图形界面替代方案）
从 Mac App Store 安装 The Unarchiver，然后右键点击 zip 包，选择「用 The Unarchiver 打开」，务必勾选「保留所有文件属性」，解压到桌面即可。这个工具比系统自带归档器靠谱得多。
⚠️ 注意：系统自带的「归档实用工具」解压后，bin/openclaw 文件权限会变为 -rw-r--r--，导致后续运行报错 Permission denied。这个问题无法回退修复，只能重新解压。所以千万别图省事用默认工具。
解压后必检三项硬指标
解压完毕别急着运行，先做三项快速检查，确保万无一失：
① 进入解压目录，执行 file bin/openclaw，返回内容必须包含 Mach-O 64-bit executable arm64（M1 芯片）或 Mach-O 64-bit executable x86_64（Intel 芯片）。如果显示的是其他架构，很可能是包下错了。
② 运行 ls -la | grep ".ds_store|__MACOSX"，输出应为空。有残留元数据说明解压过程不够干净，可能影响后续运行。
③ 检查 resources/config.yaml 是否存在且非空。用 head -n 3 resources/config.yaml 查看前三行，应该能看到 version:、gateway: 等配置项。如果文件为空或缺失，请立即回到下载和解压步骤重新操作。