遠程 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 段落正是針對這些可重現路徑做硬化。
值班時最常見的誤判，是把 IM 裡的「已收到」當成子任務已落庫；在 5.18 之前，registry 寫入失敗仍可能對外顯示 accepted，造成幽靈子任務。升級後應改以「寫入成功 → accepted → handoff 可見」三段證據鏈驗收，而不是只看通道 ACK。
註冊表寫入失敗仍報成功（已修）：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 lock 等待；在可租用的遠程 Apple Silicon 上，你把 Gateway 與圖形控制臺放在同一 VNC 桌面，能把 spawn 與 handoff 的驗收時間從「數小時扯皮」壓到二十分鐘量級，且不必為偶發的子代理並行去買整機。
若你需要一臺便於完成本文第六節同款圖形化驗收的遠程 Mac，可透過 VNCMac 下單：購買頁選節點與套餐；連線步驟見幫助中心（SSH-VNC）。