Skip to main content

​
macOS 上的 Gateway（外部 launchd）

OpenClaw.app 不再內建 Node/Bun 或 Gateway 執行環境。macOS 應用程式預期有一個外部的 openclaw CLI 安裝，不會將 Gateway 作為子行程啟動，並管理一個使用者層級的 launchd 服務來保持 Gateway 運行（若已有本地 Gateway 在運行則會連接至該 Gateway）。

​
安裝 CLI（Local 模式必需）

Mac 上預設執行環境為 Node 24。Node 22 LTS，目前為 22.16+，仍可相容使用。然後全域安裝 openclaw： 
npm install -g openclaw@<version>
macOS 應用程式的 Install CLI 按鈕也會透過 npm/pnpm 執行相同的流程（不建議使用 bun 作為 Gateway 執行環境）。

​
Launchd（Gateway 作為 LaunchAgent）

Label：
  • ai.openclaw.gateway（或 ai.openclaw.<profile>；舊版 com.openclaw.* 可能仍存在）
Plist 位置（使用者層級）：
  • ~/Library/LaunchAgents/ai.openclaw.gateway.plist （或 ~/Library/LaunchAgents/ai.openclaw.<profile>.plist）
管理器：
  • macOS 應用程式在 Local 模式下擁有 LaunchAgent 的安裝/更新權限。
  • CLI 也可以安裝它：openclaw gateway install。
行為：
  • 「OpenClaw Active」啟用/停用 LaunchAgent。
  • 關閉應用程式不會停止 gateway（launchd 會保持其存活）。
  • 若 Gateway 已在設定的連接埠上運行，應用程式會連接至它，而非啟動新的 Gateway。
日誌：
  • launchd stdout/err：/tmp/openclaw/openclaw-gateway.log

​
版本相容性

macOS 應用程式會檢查 gateway 版本與自身版本是否相符。若不相容，請更新全域 CLI 以符合應用程式版本。

​
Smoke check

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