Platforms 导读

macOS 上 Gateway 到底谁在管?默认走 launchd,别被子进程模式骗了

macOS 版 app 默认通过 launchd 管理 Gateway 生命周期,不是子进程。先搞清楚默认走 launchd,子进程模式当前并未启用。最容易踩的坑是 unsigned dev 构建会写一个 disable 标记,导致 launchd 不启动 Gateway,需要手动删掉 ~/.openclaw/disable-launchagent 才能恢复。

先讲这一页到底在解决什么

macOS 上 Gateway 到底谁在管?默认走 launchd,别被子进程模式骗了

macOS 版 app 默认通过 launchd 管理 Gateway 生命周期,不是子进程。先搞清楚默认走 launchd,子进程模式当前并未启用。最容易踩的坑是 unsigned dev 构建会写一个 disable 标记,导致 launchd 不启动 Gateway,需要手动删掉 ~/.openclaw/disable-launchagent 才能恢复。

原文共 7 节,先看 Start Here 路径:/platforms/mac/child-process 查看官方原文

第一站

🧷 launchd 更像“系统级值班表”,不是 App 自己抱着一个子进程不撒手

所以当前默认路线是 attach / install / kickstart,不是 fork 一个小孩进程看着它。

launchctl kickstart ...

像把值班中的 Gateway 重新拉起来。

launchctl bootout ...

像把这班值勤从系统表里撤下来。

~/.openclaw/disable-launchagent

这像临时贴上的“先别走 launchd”便签,常见于 unsigned dev build 快速调试。

手动终端模式

如果你真想 UI 紧挨着 Gateway 看日志,那就自己在终端里跑,不走默认托管路线。