Gateway Lifecycle

在苹果电脑上，这个软件默认会请一个叫“launchd”的系统大管家来帮忙照看“Gateway”小助手。软件自己不会像牵着小朋友的手一样直接带着小助手跑。它先会去一个约好的“港口”（就是配置好的端口）看看，小助手是不是已经在那里玩了。如果没找到，它就会请一个叫 openclaw 的外部工具去告诉大管家，让大管家把小助手叫醒。这样，你一打开电脑，小助手就会自动起床，而且如果它不小心摔倒了（崩溃了），大管家也会帮它重新站起来。

现在，软件不会像妈妈抱宝宝一样（子进程模式）直接把小助手带在身边。如果你特别想让小助手和软件窗口贴得更近，你需要自己打开一个“终端”窗口，像喊朋友一样手动叫小助手来玩。

默认的样子（大管家launchd模式）

1. 软件会请一个大管家。 软件会为你的电脑账户请一位专属的大管家，名字标签是 ai.openclaw.gateway。如果你用了 --profile 或者设置了 OPENCLAW_PROFILE 环境变量，名字就会变成 ai.openclaw.<你起的名字>。以前的名字 com.openclaw.* 它也认识。
2. 打开“本地模式”时，软件会确保大管家在岗。 当你打开了“本地模式”，软件会检查这位大管家是不是已经上班了。如果没上班，它就会让大管家开始工作，并把小助手启动起来。
3. 小助手写的日记放在大管家那里。 小助手每天做的事（日志）会写在大管家知道的日记本路径里。你可以在软件的“调试设置”里看到这本日记。

有时候大人会用一些命令和大管家说话：

• launchctl kickstart -k gui/$UID/ai.openclaw.gateway：这个命令是轻轻推一下大管家，让他立刻把小助手叫起来工作。
• launchctl bootout gui/$UID/ai.openclaw.gateway：这个命令是告诉大管家，今天可以下班了，让小助手去睡觉。 如果你给小助手起了别的名字（用了profile），记得把命令里的名字标签换成 ai.openclaw.<你起的名字>。

没有“身份证”的开发版本 如果你自己在家做了一个软件玩具（未签名的开发版本），可以用 scripts/restart-mac.sh --no-sign 这个脚本来快速重启它。为了防止大管家去找一个没有“身份证”的小助手玩，这个脚本会做一件事：

• 它在你的家里（~/.openclaw/目录）放一个叫 disable-launchagent 的小纸条，意思是“今天不要找大管家啦”。 如果后来你有了“身份证”并正常运行 scripts/restart-mac.sh，它会看到这个小纸条，并把它收走。如果你想自己把纸条拿走，可以打开终端输入：rm ~/.openclaw/disable-launchagent。

只打招呼模式 如果你想让软件永远不请大管家，可以在启动软件时加上 --attach-only（或者 --no-launchd）这个“悄悄话”。它也会在你家里放上那个“不要找大管家”的小纸条。这样，软件就只会去约好的“港口”找已经在那里玩的小助手，找不到就算了。你也可以在“调试设置”里打开或关闭这个模式。

远程模式 在“远程模式”下，软件根本不会在本地电脑启动小助手。它会像搭一条秘密隧道（SSH隧道）一样，连到另一台遥远的电脑上，和那里的小助手一起玩。

为什么我们喜欢大管家（launchd） 因为大管家很靠谱！他能让小助手在你一打开电脑时就自动起床，能在小助手摔倒时把它扶起来，还能把小助手的日记保管得整整齐齐。如果将来真的需要像抱宝宝一样（子进程模式）带着小助手，那会是一个单独的、需要特别说明的开发人员专用模式。