> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# macOS 上的閘道生命週期

macOS 應用程式預設透過 **launchd** 管理閘道，且不會將閘道
作為子程序產生。它會先嘗試連接到設定連接埠上
已在執行的閘道；如果沒有可連線的閘道，則會透過外部 `openclaw` 命令列介面
啟用 launchd 服務（沒有嵌入式
執行階段）。這能在登入時提供可靠的自動啟動，並在當機時重新啟動。

子程序模式（由應用程式直接產生閘道）目前**未使用**。
如果你需要與 UI 更緊密耦合，請在
終端機中手動執行閘道。

## 預設行為（launchd）

* 應用程式會安裝一個每位使用者專屬的 LaunchAgent，標籤為 `ai.openclaw.gateway`（或
  使用 `--profile`/`OPENCLAW_PROFILE` 時為 `ai.openclaw.<profile>`）。
* 啟用本機模式時，應用程式會確保 LaunchAgent 已載入，並
  視需要啟動閘道。
* 記錄會寫入 launchd 閘道記錄路徑（可在「偵錯設定」中查看）。

常用命令：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
launchctl kickstart -k gui/$UID/ai.openclaw.gateway
launchctl bootout gui/$UID/ai.openclaw.gateway
```

執行具名設定檔時，請將標籤替換為 `ai.openclaw.<profile>`。

## 未簽署的開發建置

`scripts/restart-mac.sh --no-sign` 用於沒有簽署
金鑰的快速本機建置。為了避免 launchd 指向未簽署的 relay binary，它會寫入
`~/.openclaw/disable-launchagent`。

如果標記存在，已簽署執行的 `scripts/restart-mac.sh` 會清除此覆寫。
若要手動重設：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
rm ~/.openclaw/disable-launchagent
```

## 僅連接模式

若要強制 macOS 應用程式永不安裝或管理 launchd，請使用
`--attach-only`（或 `--no-launchd`）啟動。這會設定
`~/.openclaw/disable-launchagent`，因此應用程式只會連接到已在
執行的閘道。可在「偵錯設定」中切換相同行為。

## 遠端模式

遠端模式永遠不會啟動本機閘道。應用程式會使用 SSH 通道連到
遠端主機，並透過該通道連線。

## 為什麼我們偏好 launchd

* 登入時自動啟動。
* 內建重新啟動/KeepAlive 語意。
* 可預測的記錄與監督。

如果未來再次需要真正的子程序模式，應將其記錄為
獨立、明確的僅限開發模式。

## 相關

* [macOS 應用程式](/zh-TW/platforms/macos)
* [閘道操作手冊](/zh-TW/gateway)