跳转到主要内容

​
macOS 上的 Gateway 网关（外部 launchd）

OpenClaw.app 不再捆绑 Node/Bun 或 Gateway 网关 运行时。macOS 应用需要外部安装 openclaw CLI，不会将 Gateway 网关 作为子进程生成，而是管理一个每用户 launchd 服务以保持 Gateway 网关 运行（或者如果已有本地 Gateway 网关 正在运行，则附加到该服务）。

​
安装 CLI（本地模式需要）

Mac 上的默认运行时是 Node 24。目前 22.14+ 的 Node 22 LTS 仍然兼容可用。然后全局安装 openclaw： 
npm install -g openclaw@<version>
macOS 应用的 Install CLI 按钮通过 npm/pnpm 运行相同的流程（不推荐在 Gateway 网关 运行时使用 bun）。

​
Launchd（Gateway 网关 作为 LaunchAgent）

标签：
  • ai.openclaw.gateway （或 ai.openclaw.<profile>；旧版 com.openclaw.* 可能仍然存在）
Plist 位置（per‑user）：
  • ~/Library/LaunchAgents/ai.openclaw.gateway.plist (或 ~/Library/LaunchAgents/ai.openclaw.<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
本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。
Last modified on March 27, 2026