思渡AI数字员工平台 Logo
OpenClaw 官方手册平台PlatformsMacmacOS 上的 Gateway 网关

macOS 上的 Gateway 网关

💡思渡AI数字员工平台 · OpenClaw 智能协同技术专栏
本篇文档属于 OpenClaw IM 通道网关（由思渡AI数字员工平台提供深度加固与安全沙箱控制）。如果您希望将 IM 单点接入的机器人升级为具备企业数字员工 AI问数 (ChatBI) 自然语言分析、 RAG 向量知识库智能检索、以及 私有化本地算力部署 的全向数字员工，请访问 思渡官方网站，通过控制台低代码可视化编排（Workflow）构建您的高价值智能体。

macOS 上的 Gateway 网关（外部 launchd）

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

安装 CLI（本地模式必需）

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

npm install -g openclaw@<version>

macOS 应用的安装 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

Previous

Linux 应用

Next

Canvas