OPENCLAW 2026
POST_INSTALL_
GATEWAY_
PATH_FORCE.

Nach npm install -g openclaw zeigt die Shell oft keinen harten Fehler, dennoch hängt openclaw ask, openclaw-gateway: command not found erscheint oder openclaw gateway status meldet fehlende Registrierung. Ursache ist typischerweise Prefix/PATH-Drift, ausgelassene Gateway-Registrierung, Node-22-Split oder launchd ohne interaktive Profile. Dieses Runbook liefert Symptom-Evidenz-Matrix, fünf Kaltstart-Schritte, harte Schwellen und FAQ; Querverweise: install.sh Produktion, LaunchAgent Token, Chrome Relay 18792, v2026.5.x Schichten. Für eine saubere Kontrollfläche empfiehlt sich ein dedizierter MACGPU Remote-Mac.

1. Schmerzpunkte

Globales bin nicht in PATH, openclaw gateway install nie ausgeführt, mehrere Node-Installationen, launchd-Minimalumgebung. API-Throttling ist die falsche erste Hypothese. Ergänzend: erfolgreiche Installer-Logs implizieren keine geschlossene Laufzeitschleife; parallele globale npm-Jobs auf geteilten Automationskonten lassen which springen. Logs auf schreibgeschützten oder Netzwerk-Mounts erzeugen Crash-Schleifen trotz „Erfolg“-Meldungen.

2. Matrix

Signal	Verdacht	Beweis
command not found	PATH	which openclaw, npm prefix -g
status: nicht installiert	Registrierung	Vor/Nach gateway install --force
interaktiv OK, launchd nicht	plist	EnvironmentVariables
nur Remote	non-login shell	ssh -t, Home-Pfad

3. Fünf Schritte

Step 1 Triple freeze

node -v (22+), which node absolut dokumentieren.

Step 2 Prefix/PATH

npm config get prefix, Shell-RC aktualisieren, sudo npm vermeiden.

Step 3 Gateway registrieren

openclaw gateway install, ggf. --force, Token-Artikel für LaunchAgent-Variablen.

Step 4 Ports

Loopback vs. SSH-Tunnel trennen; Health 18792 aus Chrome-Relay-Leitfaden.

Step 5 Kaltstart + Log-Slices

Prozess hart stoppen, neu starten, openclaw logs in Fenster schneiden.

4. Harte Gates

A: which openclaw-gateway muss existieren. B: Kein Produktionsverkehr ohne gesundes gateway status. C: Kein Tunnel-only-Betrieb ohne launchd-Kaltstart. Nach Gate B alle SSH-Sitzungen schließen und ohne manuelles export PATH erneut prüfen.

5. Fallstudie

Ein Team auf einem Remote-Mac mini (Mai 2026) rotierte API-Keys, bis PATH und Node-22-Absolutpfad in der plist fixiert und gateway install --force plus channels probe ausgeführt wurden. Der v2026.5.x-Artikel setzt dieselbe gesunde Basis voraus; Plugins und TTS-Schichten verstärken sonst nur Rauschen.

6. Branche

CLI, Gateway und Plugins versionieren sich 2026 unabhängig. Ein npm-Erfolg garantiert keinen Closed-Loop. Windows/Linux sind valide, doch Desktop- und Browser-Variablen steigen. Ein dedizierter Apple-Silicon-Referenz-Mac reduziert Streitfragen zwischen „nicht registriert“ und „Netzwerk“. Vor Hardwarekauf: auditierbare Checklisten und Kaltstart-Nachweise. Für geringere Reibung: MACGPU Remote-Mac mieten und dieses Runbook als Release-Template einfrieren.

Windows- oder Linux-Gateways sind möglich, aber wenn Grafik-Stacks und Desktop-Sitzungen mitspielen, steigt die Varianz. macOS als Referenzfläche ist eine Entscheidung für Reproduzierbarkeit und stabile Logs, nicht für Marketing. Wenn Teams eine zweite, saubere Apple-Silicon-Umgebung brauchen, lohnt sich Miete statt dauerhafter Diagnose auf geteilten Laptops.

7. Schwellen

Kaltstart > 90 s bis gesundes status: Architekturcheck. Erster lokaler ask > 25 s ohne Antwort: Gateway vor Modellen. Mehr als zwei --force-Versuche im selben Fenster: manueller Diff. PATH-Kerneinträge < drei: standardmäßig fail, bis dokumentiert anders. Logs niemals auf read-only/Netzlaufwerken ohne Ausnahmegenehmigung; geteilte Automationskonten brauchen eigene npm-Prefixe und serielle Wartungsfenster.

8. FAQ

Doctor grün, trotzdem which? Ja. Token mismatch? 401 zuerst Token-Artikel; fehlende Prozesse hier. sudo npm? Nein. Relay rot, gateway grün? Chrome-Relay-Artikel. install.sh plus npm? Doppelmetadata vermeiden, eine Strategie pro Host.