Remote-Mac (VNC) · Entscheidungsmatrix · 20-Minuten-Raster
v2026.5.18 (stabiler Rollup vom 2026-05-18) hebt Subagents von „spawn klappte irgendwie“ auf nachverfolgbar, warteschlangenfähig, rückübertragbar. Ein Spawn meldet accepted erst nach erfolgreicher initialer Registry-Schreibung; die Hauptsession unterstützt queued follow-ups und manual-turn-Priorität; abgeschlossene Kind-Runs kehren per completion handoff in die originating session zurück. Session locks und sandbox-peer-Eigentum sind gehärtet. Auf einem gemieteten Remote-Mac sehen Teams oft: Kind läuft, Hauptchat schweigt; accepted, aber leere Liste; orphaned Codex-Native-Subagents. Dieser Leitfaden liefert eine Acht-Schritte-Runbook und ein zwanzigminütiges VNC-Raster — Subagent-Grenze zu ACP/Active Memory, dann Backup, Upgrade, Abnahme unter dem gleichen macOS-User wie der Gateway-Daemon. Querverweise: Keine Antwort, launchd, v2026.5.7 Plugins, Mehrprojekt-Trennung, headless Linux vs. macOS+VNC. Wer OpenClaw bereits über CLI/Gateway-Matrix produktiv betreibt, sollte 5.18 als Orchestrierungs-Härtung lesen — nicht als weiteres Modell-Upgrade ohne Abnahme.
Zwischen 5.12 und 5.17 sind Subagent-Ausfälle selten „das Modell wurde schlechter“. Typischer sind Inkonsistenzen in der Orchestrierung: Registry nie geschrieben, aber accepted; Completion-Events erreichen die Hauptsession nicht; Codex app-server spiegelt ohne OpenClaw-Child. Diese Pfade sind reproduzierbar und gehören in Tickets mit Request-IDs, nicht in vage Modell-Debatten.
Wer nur IM-Bestätigungen archiviert, verliert die Beweiskette. Ab 5.18 muss „accepted“ durch eine Registry-Zeile oder einen UI-Eintrag belegt werden — sonst ist es kein Abnahmeartefakt.
In gemieteten Umgebungen verschärft ein falscher macOS-Kontext das Bild: Der Gateway-Daemon läuft unter Benutzer A, während VNC unter Benutzer B startet. Dann fehlen Spawn-Listen, TCC-Dialoge bleiben unsichtbar, und das Team diskutiert wochenlang Modellrouting statt einen zweiminütigen whoami-Vergleich. 5.18 zwingt zwar konsistentere Registry-Semantik — aber Benutzer-Parität bleibt Ihre Betriebsdisziplin.
Planen Sie Abnahme als drei Schichten: (1) Versions- und doctor-Schicht, (2) Registry- und Handoff-Schicht am Gateway, (3) Kanalzustellung in Telegram, Discord oder anderen Adaptern. Vermischen Sie diese Schichten in einem Ticket, und jede Retrospektive endet mit „wir haben alles gleichzeitig geändert“.
Halten Sie für jeden Spawn-Versuch dieselbe Testnachricht bereit — ein Satz, klares Ende, kein Tool-Chaos. So vergleichen Sie Registry- und Handoff-Logs zwischen 5.17 und 5.18 ohne Rauschen aus wechselnden Prompts.
Schreibfehler trotz Erfolg (behoben): Reihenfolge registry save → accepted. Fehlschlag liefert Spawn-Fehler statt Geisterjobs.
Handoff fehlt: completion handoff zur originating run session; sandbox-peer-Announcement-Routen in 5.18 repariert.
Follow-up-Rennen: queued follow-ups plus manual-turn machen Einspring-Befehle in IM-Kanälen vorhersagbar.
Codex native orphaned: Wartung für stale childless mirrors getrennt von reinem OpenClaw-Spawn dokumentieren.
Remote-Mac-Falle: SSH-User ≠ VNC-Desktop-User — fehlende Spawn-Listen wirken wie Regression.
| Prüfung | nur SSH | VNC empfohlen | Bestanden |
|---|---|---|---|
| openclaw --version / doctor | ja | optional | CLI ≥ 2026.5.18, doctor ohne Blocker |
| Registry nach Spawn | Logs + CLI | Konsole / Kinderliste | Zeile < 30 s |
| completion handoff | Haupt-Transcript | Network gleicher User | Zusammenfassung im Hauptkanal |
| queued follow-up | priority-Logs | zwei IM-Befehle | manual-turn zuerst |
| Codex native | trajectory / doctor | OAuth / Berechtigungen | keine orphaned-Warnung |
| subagents config | doctor --fix | Config-Diff | ungültige timeoutMs entfernt |
Günstigste Abnahme: SSH für Artefakte, VNC für denselben User — nicht entweder-oder.
ACP bindet die aktuelle IM-Session an eine Coding-Runtime. Subagent ist paralleler Kind-Run plus Registry-Lebenszyklus plus Handoff. Active Memory injiziert Retrieval vor der Hauptantwort — kein neuer Spawn.
Für Auditoren auf einem Remote-Mac bedeutet das: Wenn jemand „ACP repariert“ während Subagent-Spawn bricht, stoppen Sie und trennen Sie die Beweispakete. Andernfalls wird ein erfolgreicher Bind-Fix fälschlich als Handoff-Fix gewertet — und der nächste Spawn scheitert wieder an der Registry.
Das Runbook ist absichtlich linear. Parallele Änderungen an Kanälen, Plugins und Subagent-Modellen während Schritt 03–05 erzeugen nicht-debuggbare Logs. Wenn Sie unter Zeitdruck sind, verkürzen Sie den Scope des Kind-Runs — nicht die Reihenfolge der Schritte.
Einfrieren & Backup: Config-Baum, openclaw --version, Gateway-Build, Node-ID. Mehrprojekt: Trennung zuerst.
Upgrade 5.18: danach openclaw doctor — subagents-Cleanup, plugin registry repair.
Minimaler Spawn-Smoke: kurze Kind-Aufgabe mit klarem Ende; Registry-Zeile vor accepted.
Handoff prüfen: lesbare Zusammenfassung in der Hauptsession; sonst Logs zu handoff / announcement / session lock.
Warteschlangen-Follow-up: Einspring-Befehl während Kind läuft; manual-turn vor Queue — nicht mit cron mischen.
Codex-Pfad: Mapping native ↔ OpenClaw child separat festhalten.
Daemon-Neustart: launchd — keep-Registry-Zeilen nach Reboot.
Rollback-Artefakte: Logs und Transcripts ins Ticket; Installationsmatrix.
Zwischen Schritt 03 und 04 ist eine bewusste Pause sinnvoll: ein Kaffee, kein Config-Edit. Die Registry-Zeile braucht Sekunden zum Erscheinen — wer sofort die Hauptsession spamt, erzeugt Follow-up-Rauschen, das manual-turn-Tests verfälscht.
openclaw --version openclaw doctor openclaw status # Nach kurzem Subagent im Testkanal: # rg -i "subagent|handoff|registry|spawn" /path/to/gateway.log | tail -n 80
Querschnittsfixes (Telegram-Isolations-Polling, Discord-Final-Reply, pending drain beim Gateway-Neustart) erzeugen „Handoff OK, IM leer“. Zuerst Kanalzustellung, dann Registry.
In Change-Advisory-Boards hilft es, diese vier Fakten als Checkliste zu drucken — nicht als Fließtext. Reviewer fragen dann „Wo ist die Registry-Zeile?“ statt „Hat der Bot geantwortet?“. Das verkürzt Freigaben für Produktions-Upgrades auf gemieteten Macs erheblich.
CLI und Gateway auf 5.18-Linie? doctor-Hinweise zu subagents-Legacy-Keys?
Leere Liste nach Spawn → Schreibfehler oder User-Kontext, nicht zuerst Modell-Timeout.
Logs: handoff, announcement, session lock; final payload delivery für Ihren Kanal.
Kanal-Schicht: Telegram forum topic, Discord progress modes.
CPU/RAM-Druck verlängert session-lock-Wartezeiten — parallele Spawns reduzieren.
Dokumentieren Sie jeden Schritt mit Zeitstempel und Kanal-ID. On-Call-Teams, die nur Screenshots der IM-Oberfläche speichern, verlieren den Handoff-Beweis — der in Gateway-Logs oft klarer ist als in der Chat-UI.
Wenn Sie nach Schritt C Handoff in Logs sehen, aber der Hauptkanal leer bleibt, ist das kein Registry-Problem mehr. Wechseln Sie zur Kanal-Schicht und vergleichen Sie mit der Keine-Antwort-Matrix, bevor Sie ein Downgrade auf 5.17 diskutieren.
Die zwanzig Minuten sind eine gemeinsame Zeitbox für SSH- und VNC-Rollen — nicht zwanzig Minuten SSH und danach „vielleicht VNC“. Starten Sie einen Timer, weisen Sie eine Person dem Terminal und eine dem Desktop zu, und sprechen Sie Befunde laut aus, damit nichts in Chat-Threads verloren geht.
| Punkt | VNC | SSH | OK |
|---|---|---|---|
| Konsole-Version | About / Network 200 | Start-Log | = CLI 5.18 |
| Liste nach Spawn | UI-Zeile | registry-Log | < 30 s |
| handoff | Finale Hauptnachricht | handoff-Keyword | lesbar |
| manual-turn | Reihenfolge zweier Befehle | priority-Log | Einspring zuerst |
| gleicher User | Desktop = Daemon | whoami | kein Cross-User |
Auf einem VNCMac-Lease-Mac lassen sich Gateway, Browser und „Datenschutz & Sicherheit“ in einer VNC-Sitzung abnehmen — Dialoge, die SSH nie zeigt. Windows-lastige Teams sollten „SSH-Logs + VNC-Berechtigungen“ in die Linux-vs-macOS+VNC-Playbooks schreiben.
Nach bestandener Abnahme: Snapshot der Registry-Zeile, Handoff-Log-Ausschnitt und ein Screenshot der Hauptnachricht in ein Change-Record legen. Das ist die Brücke zu v2026.5.7, wenn Sie als Nächstes Plugin-Publish und Cron-JSON härten — ohne die Subagent-Baseline erneut zu überspringen.
doctor, heartbeat, Zustellung.
Lesen →Plugin-Publish, Cron.
Lesen →Daemon, Logs.
Lesen →Zuerst initiale Registry-Schreibung und originating session; Handoff-Logs. Ab 5.18: Schreibfehler → Spawn-Fehler.
Nein. ACP bindet IM an Coding-Runtime; Subagent = paralleler Run + Registry + Handoff.
CLI und Logs ja; Spawn-UI und Berechtigungsdialoge unter dem Daemon-User per VNC.
doctor: ungültige timeoutMs unter subagents entfernen; Modelle auf primary/fallback. Backup zuerst. Notieren Sie openclaw --version und Gateway-Build im Ticket — das verhindert Misch-Abnahmen über 5.17 und 5.18 hinweg.
v2026.5.18 macht parallele Automatisierung auditierbar: Registry, Queue, Handoff — bricht eine Kette, wirkt IM „stumm“. Das trennt sich von Keine-Antwort-Triage.
Eigene Hardware trägt Sleep, Bandbreite und lock-Wartezeit. Ein Lease-Mac mit einem VNC-Desktop für Gateway und Konsole drückt Abnahme auf ~20 Minuten. Stundenweise Nodes sind dafür oft günstiger als ein Dauer-Mac-mini, der nachts schläft, während Ihr Gateway Subagents in anderen Zeitzonen erwarten.
Wenn mehrere Entwickler denselben Lease-Mac teilen, definieren Sie Spawn-Fenster und verbieten Sie parallele Abnahmen ohne Kalender — sonst überlappen session locks und niemand kann Handoff-Fehler zuordnen. Dokumentieren Sie den macOS-Benutzer im Übergabe-Log; das spart beim nächsten On-Call sofort die halbe Stunde Kontext-Suche.
Für Abschnitt-6-Abnahme: VNCMac — Kaufseite, Verbindung im Hilfe-Center (SSH-VNC).