远程 Mac（VNC）按序启用 · 决策矩阵 · 二十分钟验收表
v2026.5.18（2026-05-18 稳定 rollup）把子代理从「能 spawn」推进到「可追踪、可回传、可排队」：spawn 须在注册表初始写入成功后才报告 accepted；主会话支持 queued follow-ups 与 manual-turn 优先级；子任务结束通过 completion handoff 回到 originating run session，并强化 session locks 与 sandbox-peer 所有权。若你已在远程 Mac 上跑 OpenClaw，却遇到「子代理跑了但主聊天没下文」「spawn 偶发成功、列表里却没有」「Codex 原生子任务 orphaned」——本文给一份按序 Runbook：先界定 Subagent 与 ACP/记忆子路径的边界，再备份升级，最后在与 Gateway 同用户 的 VNC 会话里交叉验收控制台与日志。文中与《任务发出却无回复排查》、《守护进程与 launchd》、《v2026.5.7 插件发布链》、《多项目隔离》互链。
在 5.12–5.17 beta 线上，子代理相关故障往往不是模型「变笨」，而是编排层状态不一致：注册表没写上就对外说 accepted、完成事件没 handoff 回主会话、或 Codex 原生子任务镜像与 OpenClaw child session 脱节。5.18 的 Agents/Subagents 段落正是针对这些可复现路径做硬化。
注册表写入失败仍报成功（已修）：5.18 要求初始 registry save 先于 accepted；写入失败应直接返回 spawn 错误，避免「幽灵子任务」。
完成回传不到主会话：handoff 须回到 originating run session；sandbox-peer 控制器所有权与 announcement 路由在 5.18 有专门修复，避免子代理在隔离沙箱里「做完就丢」。
并发 follow-up 乱序：queued follow-ups + manual-turn priority 让「用户插队指令」与后台子任务排队可预测，降低 IM 通道上的竞态。
Codex 原生子任务 orphaned：app-server 侧可恢复 stale childless 镜像并在无 OpenClaw child 时取消 registry 行；与纯 OpenClaw spawn 的排障路径要分开记录证据。
远程 Mac 特有风险：SSH 用户与 VNC 桌面用户不一致时，你看不到控制台里的 spawn 列表与系统弹窗，会把「配置没生效」误判成「5.18 回归」。
| 验收动作 | 仅 SSH | 建议 VNC | 通过标准 |
|---|---|---|---|
| openclaw --version / doctor | 足够 | 可选 | CLI ≥ 2026.5.18，doctor 无阻塞项 |
| spawn 后 registry 可见性 | 日志 + CLI 状态 | 控制台任务/子代理面板 | spawn 后 30s 内可查到条目 |
| completion handoff | 主会话 transcript 片段 | 同用户浏览器 Network | 主通道出现子任务摘要/结果 |
| queued follow-up 插队 | 日志关键字 | IM 客户端实发两条指令 | manual-turn 优先于排队任务 |
| Codex 原生 subagent | trajectory / doctor | 权限与 OAuth 弹窗 | 无 orphaned 镜像告警 |
| 配置清理（subagents） | 编辑配置 + doctor --fix | 图形化 diff 配置目录 | 移除无效 timeoutMs 等遗留键 |
子代理验收的最低成本做法：SSH 取证 + VNC 同用户复现，而不是二选一。
与ACP 频道绑定对比：ACP 解决「把当前对话挂到编码运行时」；Subagent 解决「并行子运行 + 注册表生命周期 + 回传」。与Active Memory对比：记忆子路径在主回复前插入检索，不等同于 spawn 一个新 run。
冻结与备份：导出 OpenClaw 配置目录、记录 openclaw --version、Gateway 构建号与远程节点租约 ID；多项目场景先对照目录分桶。
升级到 5.18：按你的通道（npm / 包管理 / Docker）更新后先跑 openclaw doctor，关注 subagents 配置清理与 plugin registry repair 提示。
最小 spawn 烟测：在测试通道触发一个短任务子代理（明确结束条件），确认 accepted 之前 registry 已写入；若失败，保留完整 stderr 与 request id。
验证 handoff：子任务完成后，主会话应出现可读的完成摘要；若无，查 Gateway 日志中 handoff / announcement 与 session lock 行。
排队 follow-up：在子任务运行中再发一条「插队」类指令，确认 manual-turn 优先；避免与 cron/heartbeat 混测。
Codex 路径（若启用）：对使用 Codex app-server 的 agent，单独记录 native subagent 与 OpenClaw child session 的对应关系；orphaned 时按发行说明做 maintenance 恢复。
守护进程与重启：确认 LaunchAgent/systemd 与 Gateway 重启后 registry 不丢关键 keep 模式条目；见守护进程文。
回滚证明：保留升级前后日志片段与主会话 transcript 截图，写入工单；与灰度回滚清单衔接。
openclaw --version openclaw doctor openclaw status # 在测试通道触发一次短周期 subagent，随后检查 Gateway 日志： # rg -i "subagent|handoff|registry|spawn" /path/to/gateway.log | tail -n 80
发行说明还提到 Telegram 隔离轮询、Discord 最终回复恢复、Gateway 重启时 drain pending replies 等横切修复——它们会影响「子代理跑完但通道没显示最终答案」的表象。若 handoff 在 Gateway 侧已成功而 IM 仍缺最终消息，应先对照无回复排查里的通道交付章节，再回头查 registry。
遇到故障时建议固定顺序，避免同时改配置与通道：
版本与 doctor：确认 CLI、Gateway 同为 5.18 线；doctor 是否提示 subagents 遗留键或 plugin registry repair。
registry 是否存在：spawn 后若列表为空，优先怀疑写入失败或用户上下文不一致，而非模型超时。
handoff 日志：搜索 handoff、announcement、session lock；若子代理完成但主会话无文本，对照 final payload delivery 修复是否命中你的通道。
通道层：Telegram forum topic、Discord progress 模式等可能导致「有 handoff、无可见最终回复」。
资源与锁：远程 Mac CPU/内存飙高时 session lock 等待变长；先降并发 spawn 数量再调模型。
| 核对项 | VNC 侧证据 | SSH 侧证据 | 通过标准 |
|---|---|---|---|
| Gateway 控制台版本 | 页脚/关于与 Network 200 | 进程启动日志 | 与 CLI 5.18 一致 |
| spawn 后子代理列表 | UI 或会话面板出现条目 | registry 相关日志 | 30s 内可见 |
| handoff 回主会话 | 主通道最终消息 | handoff 关键字 | 摘要或结果可读 |
| manual-turn 插队 | 两条指令时序正确 | priority 日志 | 插队指令先被处理 |
| 同用户上下文 | 桌面用户 = 守护进程用户 | whoami 对照 | 无跨用户误判 |
在租用远程 Mac 上，VNCMac 一类物理隔离节点的好处是：你可以把 Gateway、浏览器控制台与系统「隐私与安全性」放在同一图形会话里完成 5.18 子代理验收，而不必在 SSH 里猜测弹窗是否被点掉。若团队主力机仍是 Windows，建议固定「SSH 拉日志 + VNC 点权限」的双轨值班模板，写进与Linux 无桌面 vs macOS+VNC一致的运维手册。
先查注册表初始写入与 originating session；再看 handoff 日志。5.18 前常见的「写入失败仍 accepted」应已收敛为明确 spawn 错误。
不是。ACP 绑定当前 IM 会话到编码运行时；Subagent 是独立子运行 + 注册表 + 回传。请分文档分证据包排障。
CLI 与日志可 SSH；控制台可见性与权限弹窗建议 VNC 与守护进程同用户交叉验证。
运行 doctor，清理 subagents 下无效 timeoutMs 等；subagent 模型配置收敛到 primary/fallback。务必先备份配置目录。
v2026.5.18 对子代理的意义，是把并行自动化从「碰运气」变成「可审计的编排」：注册表、排队与 handoff 任何一环断裂，都会在 IM 里表现为「AI 没反应」——而这正是无回复排查与本文的分工边界。
自有 Mac 或自建 VPS 仍要承担睡眠策略、出口带宽与多人抢用同一台机器时的 session 锁 等待；在可租用的远程 Apple Silicon 上，你把 Gateway 与图形控制台放在同一 VNC 桌面，能把 spawn 与 handoff 的验收时间从「数小时扯皮」压到二十分钟量级，且不必为偶尔的子代理并行去买整机。
若你需要一台便于完成本文第六节同款图形化验收的远程 Mac，可通过 VNCMac 下单：购买页选节点与套餐；连接步骤见帮助中心（SSH-VNC）。