跳轉到主要內容

​
macOS 上的 Gateway（外部 launchd）

OpenClaw.app 不再內建 Node/Bun 或閘道執行環境。 OpenClaw.app 不再內建 Node/Bun 或 Gateway 執行環境。macOS 應用程式 預期安裝外部的 openclaw CLI，不會將 Gateway 作為子行程啟動， 而是管理每位使用者的 launchd 服務以保持 Gateway 持續執行 （或在本機已有 Gateway 正在執行時附加至該 Gateway）。 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 正在執行，應用程式會附加至該 Gateway，而非啟動新的實例。
記錄：
  • launchd stdout/err：/tmp/openclaw/openclaw-gateway.log

​
版本相容性

macOS App 會檢查閘道版本是否與自身版本一致。 若它們 不相容，請更新全域 CLI 以符合 App 版本。

​
煙霧測試

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