macOS 伴侣应用
macOS 上的网关
OpenClaw.app 不再内置 Node/Bun 或网关运行时。macOS 应用需要外部安装 openclaw CLI，它不会以子进程方式启动网关，而是通过每用户的 launchd 服务来保持网关运行（或者，如果已有本地网关在运行，则直接连接到该网关）。
安装 CLI（本地模式必需）
你的 Mac 需要 Node 22+，然后全局安装 openclaw：
npm install -g openclaw@<version>
macOS 应用的 安装 CLI 按钮通过 npm/pnpm 执行相同的安装流程（不推荐使用 bun 作为网关运行时）。
Launchd（网关作为 LaunchAgent）
标签：
ai.openclaw.gateway（或使用--profile/OPENCLAW_PROFILE时为ai.openclaw.；旧版com.openclaw.*仍受支持）
Plist 位置（每用户）：
~/Library/LaunchAgents/ai.openclaw.gateway.plist（或~/Library/LaunchAgents/ai.openclaw..plist）
管理方式：
- 本地模式下，macOS 应用负责 LaunchAgent 的安装/更新。
- CLI 也可以安装：
openclaw gateway install。
行为：
- "OpenClaw 活跃" 开关控制 LaunchAgent 的启用/禁用。
- 应用退出不会停止网关（launchd 会保持其运行）。
- 如果网关已在 配置的端口上运行，应用会连接到该网关，而不是启动新实例。
日志：
- launchd 标准输出/错误：
/tmp/openclaw/openclaw-gateway.log
版本兼容性
macOS 应用会检查网关版本与其自身版本的兼容性。如果版本不兼容，请更新全局 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