1. 为什么在 Mac 上部署 OpenClaw 值得单独说
OpenClaw 支持多平台，但 Mac（尤其 Apple Silicon）在环境路径、Homebrew 与 npm 全局目录、Gatekeeper 与权限、以及后台常驻方式上与 Linux/Windows 不同。不少人在本机或远程 Mac 上安装时卡在「命令找不到」、EACCES 权限或端口被占，本文按 Mac 专属路径给出可复现的完整步骤与排查表。
2. Mac 环境准备（Xcode CLI、Homebrew、Node）
第一步： 安装 Xcode Command Line Tools。终端执行 xcode-select --install，按提示完成；否则 Homebrew 及后续编译会报错。
第二步： 安装 Homebrew。执行官方一键脚本：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。若为 Apple Silicon，安装后必须把 Homebrew 加入 PATH：echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile，再 source ~/.zprofile。
第三步： 安装 Node.js 22+。推荐用 nvm：brew install nvm，按提示配置 shell，然后 nvm install 22、nvm use 22。或直接 brew install node@22 并 brew link node@22 --force。用 node -v 与 npm -v 确认。
3. 安装方式对比与推荐
| 方式 | 命令/说明 | 适用场景 |
|---|---|---|
| npm 全局 | npm install -g openclaw@latest | 已有 Node 环境，快速体验 |
| 官方安装脚本 | curl -fsSL https://openclaw.ai/install.sh | bash | 一键完成依赖与 PATH |
| Docker | 使用官方或社区 OpenClaw 镜像 | 隔离环境、与宿主机解耦 |
4. 五步安装与首次运行
第一步： 选择安装方式并执行（如 npm install -g openclaw@latest）。若遇 EACCES: permission denied，可执行 sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} 修复 npm 全局目录权限。
第二步： 确认命令可用。新开终端执行 openclaw --version（或当前文档中的入口命令）。若提示「命令未找到」，检查 PATH 是否包含 npm 的 global bin 目录（npm config get prefix 下的 bin）。
第三步： 按官方文档执行初始化（如 openclaw onboard）并配置 API Key 等。若使用 Web 控制台，默认端口常为 18789 或 3000，确保防火墙或安全组已放行。
第四步： 启动网关/服务（如 openclaw gateway 或 openclaw start）。在浏览器访问对应端口验证控制台是否正常。
第五步： 做一次最小化验证（如通过控制台或 CLI 发一条测试请求），确认端到端可用后再配置开机自启或后台保活。
5. Apple Silicon 特别注意
（1）Homebrew 路径：Apple Silicon 上 Homebrew 安装在 /opt/homebrew，需将 /opt/homebrew/bin 加入 PATH，否则 brew、node 等可能找不到。（2）Rosetta 2：部分 npm 原生模块可能提示安装 Rosetta，按系统提示安装即可。（3）Gatekeeper：若从非 App Store 安装的二进制被拦截，在「系统设置 → 隐私与安全性」中选择「仍要打开」。
6. Mac 常见问题排查表
| 现象 | 可能原因 | 建议操作 |
|---|---|---|
| 命令未找到（openclaw / node） | PATH 未含 Homebrew 或 npm global bin | 在 ~/.zprofile 或 ~/.bash_profile 中添加对应路径并 source |
| EACCES 权限错误 | npm 全局目录属主不是当前用户 | chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share} |
| 端口已被占用 | 默认端口被其它进程占用 | 修改配置换端口或 lsof 查占用进程后关闭 |
| 控制台无法访问 | 防火墙或安全组未放行 | macOS 防火墙允许该应用；若为远程 Mac，放行 18789/3000 等端口 |
| 关盖或锁屏后进程退出 | 默认未做后台保活 | 使用 LaunchAgent 或 nohup/screen 保持常驻；或部署到远程 Mac 24/7 运行 |
7. 小结与延伸：在远程 Mac 上 24/7 运行 OpenClaw
在本地 Mac 上安装并跑通 OpenClaw 后，若需要 24/7 在线、不占本机资源或避免关盖/休眠导致中断，可将 OpenClaw 部署到远程 Mac 节点。远程 Mac 同样为 macOS，环境与本文步骤一致，且可专机专用、稳定常驻。若你希望省去本机保活与运维负担，可直接租赁 MACGPU 的远程 Mac 节点，在标准化 macOS 下按本文步骤安装 OpenClaw，一次配置、长期稳定运行。