> ## Documentation Index
> Fetch the complete documentation index at: https://claw-tw.jackle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Gateway on macOS（macOS 上的 Gateway）

# 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`：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw --version

OPENCLAW_SKIP_CHANNELS=1 \
OPENCLAW_SKIP_CANVAS_HOST=1 \
openclaw gateway --port 18999 --bind loopback
```

接著：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway call health --url ws://127.0.0.1:18999 --timeout 3000
```