Gateway 在 macOS 上的生命周期

适用范围

在以下情况使用此页面：

macOS 应用通过 launchd 管理网关，默认不将网关生成为子进程。它首先尝试附加到配置端口上已运行的网关；如果无法访问，它通过外部 clawdbot CLI 启用 launchd 服务（无嵌入式运行时）。这为你提供了可靠的登录时自动启动和崩溃时重启。

子进程模式（应用直接生成网关）今天未使用。如果你需要与 UI 更紧密的耦合，请在终端中手动运行网关。

应用安装标记为 com.clawdbot.gateway 的每用户 LaunchAgent（使用 --profile/CLAWDBOT_PROFILE 时为 com.clawdbot.<profile>）。
启用本地模式时，应用确保 LaunchAgent 已加载并在需要时启动网关。
日志写入 launchd 网关日志路径（在调试设置中可见）。

常用命令：

launchctl kickstart -k gui/$UID/com.clawdbot.gateway
launchctl bootout gui/$UID/com.clawdbot.gateway

运行命名配置文件时，将标签替换为 com.clawdbot.<profile>。

scripts/restart-mac.sh --no-sign 适用于没有签名密钥时的快速本地构建。为了防止 launchd 指向未签名的中继二进制文件，它：

如果标记存在，scripts/restart-mac.sh 的签名运行会清除此覆盖。要手动重置：

rm ~/.clawdbot/disable-launchagent

要强制 macOS 应用永不安装或管理 launchd，请使用 --attach-only（或 --no-launchd）启动它。这会设置 ~/.clawdbot/disable-launchagent，因此应用仅附加到已运行的网关。你可以在调试设置中切换相同的行为。

远程模式从不启动本地网关。应用使用到远程主机的 SSH 隧道并通过该隧道连接。

如果再次需要真正的子进程模式，应该将其记录为单独的、显式的仅开发模式。