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 才能恢复。
第一站
🧷 launchd 更像“系统级值班表”,不是 App 自己抱着一个子进程不撒手
所以当前默认路线是 attach / install / kickstart,不是 fork 一个小孩进程看着它。
launchctl kickstart ...像把值班中的 Gateway 重新拉起来。
launchctl bootout ...像把这班值勤从系统表里撤下来。
~/.openclaw/disable-launchagent这像临时贴上的“先别走 launchd”便签,常见于 unsigned dev build 快速调试。
手动终端模式
如果你真想 UI 紧挨着 Gateway 看日志,那就自己在终端里跑,不走默认托管路线。