OpenClaw.app 不再内置 Node/Bun 或 Gateway 运行时。macOS 应用通过外部 openclaw CLI 管理 per-user launchd 服务，或连接已运行的本地 Gateway。
安装 CLI（本地模式必需）
# Node 24 推荐，Node 22 LTS 兼容
npm install -g openclaw@<version>应用内 “Install CLI” 按钮会自动选择包管理器（优先 npm，其次 pnpm，最后 bun）。
Launchd 配置
| 项目 | 值 |
|---|---|
| 标签 | ai.openclaw.gateway（或 ai.openclaw.<profile>） |
| Plist 位置 | ~/Library/LaunchAgents/ai.openclaw.gateway.plist |
| 日志 | /tmp/openclaw/openclaw-gateway.log |
行为：
- “OpenClaw Active” 开关控制 LaunchAgent 的启用/禁用
- 退出应用不会停止 Gateway（launchd 保持运行）
- 如果配置端口上已有 Gateway 运行，应用直接连接而不启动新实例
版本兼容性
macOS 应用会检查 Gateway 版本。不兼容时，更新全局 CLI 以匹配应用版本。
冒烟测试
openclaw --version
OPENCLAW_SKIP_CHANNELS=1 OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000相关链接
- platform-macos — macOS 平台总览
- platform-mac-child-process — Gateway 生命周期