2026 OpenClaw: Geplante Aufgaben & Zeitsteuerung auf headlosem Fern-macOS — keine Ausführung oder Timeout? Gateway-Lebenszyklus, Umgebungsvariablen & launchd-Abgleich: reproduzierbare Checkliste + FAQ
Auf einem dedizierten Fern-Mac im headless-Betrieb scheitern „später ausführen“-Aufgaben unter OpenClaw oft aus banalen Gründen: Das Gateway wurde neu gestartet und hat In-Memory-Timer verworfen, launchd-Jobs erben ein anderes PATH als Ihre SSH-Shell, oder die Energieverwaltung von macOS hat die Ausführung verschoben. Dieser Leitfaden trennt Planer-Symptome vom Gateway-Lebenszyklus, vergleicht launchd mit interaktiven Shells und liefert eine reproduzierbare SSH-Checkliste. Für Always-on-Gateway-Muster auf anderen Plattformen siehe OpenClaw plattformübergreifend: WSL2 vs. Linux (systemd), Gateway-Autostart & SSH-Hybrid-FAQ; für geplante CI-ähnliche Last auf Apple-Hardware liefert Entscheidungsmatrix: iOS-CI mit Xcode Cloud oder selbst gehosteten GitHub Actions auf Mac mini Kontext zu Warteschlangen und Timeouts außerhalb von OpenClaw.
1. TL;DR — zuerst klassifizieren
Läuft gar nicht: prüfen Sie launchd (nicht geladen), falschen Benutzerkontext, fehlende EnvironmentVariables oder ein nicht laufendes Gateway, das Arbeit nicht annimmt.
Läuft, aber Timeout: oft kalte Caches, im Headless blockierte Schlüsselbund-Dialoge, Netzwerk zu Modell-APIs oder Parallelitätslimits — häufig fälschlich als „Planer-Bug“ gelesen.
- Ein Log-Anker: Gateway-Stdout/Stderr und die
StandardOutPath-/StandardErrorPath-Dateien Ihres Wrappers im selben Zeitfenster. - Ein Umgebungs-Anker:
OPENCLAW_*im launchd-Job ausgeben — nicht nur in der SSH-Session. - Ein Lebenszyklus-Anker: ob das Gateway zwischen Plan und Ausführung neu startete (Konfig-Reload, OOM, manuelles
launchctl kickstart).
2. Gateway-Lebenszyklus vs. „der Planer“
OpenClaw hält typischerweise langlebige Verbindungen und Routing-Zustand im Gateway-Prozess. Beendet sich dieser, kann geplante oder verzögerte Arbeit, die nur im RAM lag, nicht zur erwarteten Zeit feuern — selbst wenn launchd die Binary Sekunden später neu startet.
Reproduzierbare Checks:
- Neustarts mit Logzeilen zu Hot-Reload, Port-Bind-Fehlern oder Token-Rotation für
OPENCLAW_GATEWAY_TOKENkorrelieren. - Für kritische Aufgaben lieber externe Planung (
cron/launchdmit schlankem CLI) — In-Gateway-Timer nur als best effort, sofern nicht anders dokumentiert. - Nach
launchctl bootout && bootstrapKopplung und Worker-Gesundheit erneut verifizieren.
Vertiefung zu Stabilität auf Bare Metal und Abgrenzung von Deployment-Modellen: 2026 OpenClaw Bare-Metal-Performance: Warum physische Mac minis ClawHub-Sicherheit & NanoClaw-Effizienz garantieren und OpenClaw Sicherheits-Deployment 2026: Self-Hosted vs. Cloud SSH/CLI Umgebungen.
3. Umgebung: drei Welten, die zusammenpassen müssen
Headless-Macs enttäuschen Erwartungen, weil SSH-Login-Shells, GUI-Sitzungen und launchd jeweils andere Dateien einlesen und unterschiedliche PATH-Werte tragen.
| Kontext | Typische Quelle | Risiko |
|---|---|---|
launchd LaunchAgent |
Plist EnvironmentVariables / Wrapper-Skript |
Fehlendes HOME, PATH, API-Keys |
| SSH interaktiv | ~/.zprofile, ~/.zshrc |
„Geht per SSH“, nicht vom Daemon |
macOS cron |
Minimale Umgebung; oft kein Homebrew auf PATH |
Stilles Scheitern oder falsche Binary |
Muster: Geheimnisse und Pfade in einer Datei bündeln (z. B. dedizierte Env-Datei) und in der Plist oder einem kleinen Wrapper explizit referenzieren — nicht auf interaktive Shell-Init vertrauen.
4. launchd-Checkliste (reproduzierbar)
Auf dem Fern-Mac per SSH in dieser Reihenfolge:
- Label & Domäne: Benutzeragenten unter
~/Library/LaunchAgents, pro Benutzer laden — System-Daemons anders; Domänen zu mischen ist ein häufiger „läuft nie“-Fehler. - Program vs. Argumente: absolute Pfade für Binary und Konfigurationsdateien.
- WorkingDirectory: explizit setzen bei relativen Pfaden oder Unix-Sockets.
- RunAtLoad / StartCalendarInterval / StartInterval: Trigger mit dem mentalen Modell (Boot vs. Uhrzeit) abgleichen.
- ThrottleInterval / KeepAlive: enge Respawn-Schleifen vermeiden, die geplante Arbeit verhungern lassen.
- StandardOutPath / StandardErrorPath: immer auf tail-bare Dateien — Headless-Triage ohne Logs ist Blindflug.
- Harte Ressourcengrenzen: bei Last Dateideskriptoren und Speicher prüfen.
5. Besonderheiten: headless Fern-Mac
- Energie & Ruhezustand: Auch Desktop ohne Akku kann Komponenten drosseln; Last muss zu unbeaufsichtigtem Aufwachen passen.
- GUI vs. SSH: Aufgaben mit WindowServer oder Bedienhilfen brauchen ggf. eine authentifizierte Konsolensitzung — reine SSH ersetzt das nicht.
- Zeitzonen:
TZund Wandzeit loggen; verteilte Teams deuten „verspätete“ Jobs ständig falsch. - Platte & I/O: Timeouts steigen bei gleichzeitigem CI oder Modell-Downloads — korrelieren.
6. FAQ — Symptom → nächster Schritt
| Symptom | Wahrscheinliche Ursache | Nächster Schritt |
|---|---|---|
| Job erscheint nie in Logs | Plist nicht geladen / falscher Benutzer | launchctl list, bootstrap, Domäne korrigieren |
| Manuell per SSH ok, nicht per cron | PATH / Umgebungsdrift |
Absolute Pfade; Env inline in der Plist |
| Timeouts nach fester Dauer | Client-Deadline vs. Kaltstart | Caches wärmen; Preflight von Arbeit trennen |
| Unzuverlässig nach Konfig-Änderung | Gateway-Neustart hat Timer verworfen | Planung externalisieren; Neustart-Logs prüfen |
Auf einem Mac mini bleiben Zeitpläne „langweilig“ — im positiven Sinn
Zuverlässige Planung hängt vor allem von Prozessstabilität, korrekter Umgebungsvererbung und vorhersehbarem Energiezustand ab. Ein Mac mini mit Apple Silicon liefert das leise: macOS bleibt wochen- oder monatelang stabil, ohne die Absturzrate vieler Standard-PCs, und der Leerlauf-Stromverbrauch ist so niedrig, dass Always-on-Gateways und periodische Jobs weder thermisch noch akustisch an Grenzen stoßen.
Für Entwickler und Betrieb bedeuten natives Unix-Tooling, vorhersagbare launchd-Semantik und SSH-first-Workflows weniger „geht auf meinem Laptop“-Überraschungen, sobald die Plists stimmen. Gatekeeper und SIP reduzieren zudem Überraschungen durch unerwartete Binary-Ersetzungen in Cron-Wrappers.
Wenn Sie diese Checkliste auf Hardware fahren wollen, die für 24/7 am Schreibtisch gebaut ist, ist der Mac mini M4 ein pragmatischer Einstieg — kompakt, effizient und leicht neben anderem Lab-Equipment aufzustellen.
Auf der SSHMac-Startseite loslegen und einen Plan wählen, der zu Parallelität, Speicher und Always-on-Gateway passt.