OpenClaw 网关用 launchd 常驻时，常见痛点是掉线、秒退、端口冲突与双 plist 同 Label。下文按 doctor → status → logs 写，适合 SSH 常驻 Mac照做；命令以当前版本文档为准。
一、doctor / status / logs 对照
任何「网关不稳」先跑完这三步再改配置。
- Doctor：
openclaw doctor（或等价入口）看目录权限、令牌、版本与网络探测是否标红。 - Status：按文档做健康检查，确认监听地址/端口与 plist 参数一致。
- Logs：应用日志看业务错误；
log show过滤 launchd 看退出码与 Throttle。
二、launchd 症状速判
狂重启看退出码与 throttle；不自启核对用户域/全局域 plist。配置未稳前别依赖 KeepAlive 硬拉。
三、端口与 bind
端口以文档为准（如 18789）。lsof -nP -iTCP:端口 -sTCP:LISTEN 看监听进程；Docker 与 launchd 勿双启。外网不通而本机 curl 正常，查 127.0.0.1 绑定与防火墙。
四、双 LaunchAgent 冲突
同名 Label 或登录项与 LaunchAgent 双拉会抢端口与锁。launchctl list 搜前缀，~/Library/LaunchAgents 与 /Library/LaunchAgents 搜 Label；废弃项先 bootout 再删 plist。网关与 Runner 同机见：了解更多：多 Mac Runner 与持久磁盘 FAQ。
五、远程可复现步骤
SSH：doctor → launchctl print 看 state/exit code → tail 应用日志并 log stream 看 launchd → 停服务 lsof 验端口 → kickstart -k 热启，最后 reboot 验收。Actions 编排见：了解更多：OpenClaw 手把手部署与自动化集成手册。
常驻网关，为什么值得放在 Mac mini 上跑
launchd 配 Mac mini 低待机功耗与静音，适合 7×24 网关；macOS 上 Brew、Docker 与 OpenClaw 路径一致。Gatekeeper、SIP、FileVault 也降低无人值守被拖垮风险。
若要把网关落在独享远程 Mac，Mac mini M4 性价比高——单机 doctor、plist、端口跑顺再加节点更稳。前往 Macstripe 首页 查看机型与区域。
