Gateway 生命周期（macOS）
macOS 应用默认通过 launchd 管理 Gateway，不会将 Gateway 作为子进程启动。它首先尝试连接到配置端口上已运行的 Gateway；如果没有可达的 Gateway，则通过外部 openclaw CLI（无嵌入运行时）启用 launchd 服务。这为你提供了可靠的登录自动启动和崩溃重启功能。子进程模式（由应用直接启动 Gateway）目前未使用。如果你需要与 UI 更紧密的耦合，请在终端中手动运行 Gateway。
默认行为（launchd）
- 应用安装一个用户级 LaunchAgent，标签为
ai.openclaw.gateway（使用--profile/OPENCLAW_PROFILE时为ai.openclaw.<用户名>；旧版com.openclaw.**仍受支持）。 - 启用本地模式时，应用确保 LaunchAgent 已加载，并在需要时启动 Gateway。
- 日志写入 launchd gateway 日志路径（在调试设置中可见）。
常用命令：
bash
launchctl kickstart -k gui/$UID/ai.openclaw.gateway
launchctl bootout gui/$UID/ai.openclaw.gateway使用命名 profile 时，将标签替换为 ai.openclaw.<用户名>。
未签名的开发构建
scripts/restart-mac.sh --no-sign 用于没有签名密钥时的快速本地构建。为防止 launchd 指向未签名的中继二进制文件，它会：
- 写入
~/.openclaw/disable-launchagent。
scripts/restart-mac.sh 的签名运行会清除此标记（如果存在）。手动重置：
bash
rm ~/.openclaw/disable-launchagent仅附加模式（Attach-only）
要强制 macOS 应用永不安装或管理 launchd，请使用 --attach-only（或 --no-launchd）启动。这会设置 ~/.openclaw/disable-launchagent，使应用仅连接到已运行的 Gateway。你也可以在调试设置中切换此行为。
远程模式
远程模式从不启动本地 Gateway。应用使用 SSH 隧道连接到远程主机，并通过该隧道进行通信。
为什么我们选择 launchd
- 登录时自动启动。
- 内置的重启/KeepAlive 语义。
- 可预测的日志和监控。
如果将来需要真正的子进程模式，应将其作为单独的、显式的仅开发模式记录。