Platforms 导读
macOS 版 Gateway：不再内置，需要手动装 CLI
新版 macOS 应用不再捆绑 Node 或 Gateway 运行时，必须先用 npm 全局安装 openclaw CLI。安装后应用会通过 launchd 管理 Gateway 进程，或附着到已有本地 Gateway。最容易踩的坑是版本不匹配——如果 CLI 版本与应用版本不一致，Gateway 会启动失败，需要手动更新 CLI。
先讲这一页到底在解决什么
macOS 版 Gateway：不再内置，需要手动装 CLI
新版 macOS 应用不再捆绑 Node 或 Gateway 运行时，必须先用 npm 全局安装 openclaw CLI。安装后应用会通过 launchd 管理 Gateway 进程，或附着到已有本地 Gateway。最容易踩的坑是版本不匹配——如果 CLI 版本与应用版本不一致，Gateway 会启动失败，需要手动更新 CLI。
第一站
🧰 先装 CLI，就像先把发动机装进 Mac
App 自己不会再把 Node/Bun/Gateway 打包带着跑。
npm install -g openclaw@<version>这句就是把 Gateway 发动机装进系统里。
Install CLI 按钮
App 里的按钮，本质上也是在帮你跑同样的全局安装动作。
LaunchAgent
装好后会由 launchd 负责常驻，就像把发动机挂进系统后台值班表。
🎈 最后记一句
现在的 Mac app 是调度员，不是自带引擎的一体机。