跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
macOS 上的 Gateway 生命週期

macOS app 預設會透過 launchd 管理 Gateway，不會將 Gateway 生成為子行程。它會先嘗試連接到設定連接埠上已在執行的 Gateway；如果無法連上任何 Gateway，就會透過外部 openclaw CLI 啟用 launchd 服務（沒有嵌入式執行階段）。這能提供可靠的登入時自動啟動，以及當機後重新啟動。 子行程模式（由 app 直接生成 Gateway）目前未使用。如果你需要與 UI 更緊密耦合，請在終端機中手動執行 Gateway。

​
預設行為（launchd）

  • app 會安裝一個每位使用者專用的 LaunchAgent，標籤為 ai.openclaw.gateway （使用 --profile/OPENCLAW_PROFILE 時則為 ai.openclaw.<profile>；也支援舊版 com.openclaw.*）。
  • 啟用本機模式時，app 會確保 LaunchAgent 已載入，並在需要時啟動 Gateway。
  • 記錄會寫入 launchd gateway 記錄路徑（可在偵錯設定中查看）。
常用命令： 
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 二進位檔，它會：
  • 寫入 ~/.openclaw/disable-launchagent。
如果該標記存在，執行已簽署的 scripts/restart-mac.sh 會清除此覆寫。若要手動重設： 
rm ~/.openclaw/disable-launchagent

​
僅附加模式

若要強制 macOS app 永不安裝或管理 launchd，請使用 --attach-only（或 --no-launchd）啟動。這會設定 ~/.openclaw/disable-launchagent，因此 app 只會附加到已在執行的 Gateway。你也可以在偵錯設定中切換相同行為。

​
遠端模式

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

​
我們偏好 launchd 的原因

  • 登入時自動啟動。
  • 內建重新啟動/KeepAlive 語意。
  • 可預期的記錄與監督。
如果日後再次需要真正的子行程模式，應將其記錄為獨立且明確的僅限開發模式。

​
相關內容