macOS 上的 Gateway(外部 launchd)

OpenClaw.app 不再捆绑 Node/Bun 或 Gateway 运行时。macOS 应用期望使用外部的 openclaw CLI 安装,不会将 Gateway 作为子进程启动,而是通过管理每用户的 launchd 服务来保持 Gateway 运行(或者如果已有本地 Gateway 正在运行,则连接到现有的本地 Gateway)。

安装 CLI(本地模式必需)

你需要在 Mac 上安装 Node 22+,然后全局安装 openclaw:

npm install -g openclaw@<version>

macOS 应用的 Install CLI 按钮通过 npm/pnpm 运行相同的流程(不推荐使用 bun 作为 Gateway 运行时)。

Launchd(Gateway 作为 LaunchAgent)

标签:

• bot.molt.gateway(或 bot.molt.<profile>;旧版 com.openclaw.* 可能仍然存在)

Plist 位置(每用户):

• ~/Library/LaunchAgents/bot.molt.gateway.plist (或 ~/Library/LaunchAgents/bot.molt.<profile>.plist)

管理器:

• macOS 应用在本地模式下负责 LaunchAgent 的安装/更新。
• CLI 也可以安装它:openclaw gateway install。

行为:

• "OpenClaw Active" 启用/禁用 LaunchAgent。
• 应用退出不会停止 gateway(launchd 会保持其运行)。
• 如果配置端口上已有 Gateway 正在运行,应用会连接到它而不是启动新的。

日志:

• launchd 的 stdout/err:/tmp/openclaw/openclaw-gateway.log

版本兼容性

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