Auf einem Remote-Mac entscheiden Node-Version und absolute Pfade, ob openclaw doctor und openclaw gateway status --format json dasselbe sehen wie Ihre Health-Sonde. Die Gateway-Dokumentation (Stand 2026) nennt den Standard-TCP-Port 18789 und eine Loopback-Bindung für lokale Checks — dieses Tutorial führt von der Installation bis zur Statussonden-Kette ohne zusätzliche, hier nicht belegte CLI-Unterbefehle. Vertiefung: Status-JSON & CI-Vorfeld, Gateway-Token, config validate im CI-Gate.

Drei typische Hänger vor der Abnahme

Erstens nutzt die interaktive SSH-Session ein anderes node als der launchd-Daemon — dann stimmen Arbeitsverzeichnis und Module nicht überein. Zweitens lauscht ein Fremdprozess auf 18789, sodass JSON-Status und lsof auseinanderlaufen. Drittens fehlt das OPENCLAW_GATEWAY_TOKEN in der Plist, während Ihr curl es in der Shell setzt: Die sekundäre Health-Probe verhält sich anders als später in Produktion. Die folgenden H2-Abschnitte adressieren diese Punkte der Reihe nach.

Voraussetzung Node 22+ und Pfad-Fixierung

OpenClaw setzt eine aktuelle Node-Laufzeit voraus; halten Sie sich an die in Ihrer Umgebung freigegebene Mindestversion ab Major 22 (Team-Pinning z. B. 22.14+ oder 24 LTS, je nach Freigabeliste). Erfassen Sie node -v, npm -v und node -p "process.execPath" in einem kurzen Preflight-Log. Tragen Sie in der LaunchAgent-ProgramArguments-Kette dieselbe absolute Node-Binary ein, die Sie in der Shell verwenden — reine nvm-Shell-Funktionen ohne persistente PATH-Zeile reichen für Daemon-Jobs nicht aus.

Installationspfad wählen: offizielles Skript oder npm global

Wählen Sie genau eine Route pro Maschine und dokumentieren Sie sie im Runbook. Beide Wege installieren dasselbe CLI-openclaw, aber unterschiedliche Prefixe und Update-Prozesse erschweren gemischten Betrieb.

Route Eignung Risiko / Mitigation
Offizielles Install-Skript (laut Herstellerdoku per curl o. Ä.) Schnelle Angleichung an die dokumentierte Referenzinstallation Integrität der Download-Quelle und Freigabe in der Organisation regeln
npm install -g openclaw@<Version> Reproduzierbare Version in package.json-ähnlichen Pins und CI-Spiegeln npm prefix, Berechtigungen und mehrere Node-Installationen prüfen

Nach der Installation: which openclaw und openclaw --version in dieselbe Abnahme-Datei schreiben wie den Node-Pfad.

Loopback-Gateway, Port 18789 und Token

Richten Sie Smoke- und Abnahmetests gegen 127.0.0.1 und den in der Gateway-Dokumentation beschriebenen Standardport 18789 aus — das entspricht der üblichen Loopback-Bindung für lokale Sonden. Wenn Sie wie unter Produktionsbedingungen mit Authorization: Bearer auf http://127.0.0.1:18789/health prüfen, muss OPENCLAW_GATEWAY_TOKEN in interaktiver Session, Skript und LaunchAgent-EnvironmentVariables identisch sein. Nicht-Loopback-Bindungen und ausführliche Token-Patterns finden Sie im verlinkten Token-Artikel.

Daemon, LaunchAgent und Neustart-Check

Führen Sie openclaw onboard --install-daemon aus und prüfen Sie anschließend Label, Programmzeile und Umgebungsblock der erzeugten LaunchAgent-Plist: Benutzer, OPENCLAW_HOME und Arbeitsverzeichnis müssen zum Konto passen, unter dem Sie später doctor ausführen. Starten Sie den Mac testweise neu und wiederholen Sie openclaw doctor — so fangen Sie fehlende Anmeldeobjekt- oder PATH-Regressionen vor dem Go-Live.

Häufige Fehlerfingerabdrücke und Rollback

Signatur oder Symptom Priorisierte Maßnahme
EADDRINUSE / address already in use oder lsof zeigt fremden Prozess auf 18789 Altprozess sauber beenden, Konfiguration mit dokumentiertem Port abstimmen, erneut gateway status und lsof vergleichen
connection refused oder Status-Timeout Plist laden, Node-Pfad und OPENCLAW_HOME gegenüber interaktiver Shell prüfen, kurz warten, gateway status --format json wiederholen
doctor meldet Rechte- oder Home-Verzeichnis-Warnungen Ownership des Datenverzeichnisses korrigieren, WorkingDirectory in der Plist angleichen, ggf. letzten Konfig-Checkpoint wiederherstellen

Rollback-Minimalplan: LaunchAgent entladen, vorher gesicherten Konfigurationsbaum oder die zuletzt funktionierende gepinnte npm-Version wiederherstellen, dann dieselbe Sonden-Kette wie unten erneut ausführen.

Abnahme-Kette: validate → doctor → Status-JSON → Health-Sonde

Folgende Schrittfolge lässt sich in Tickets und Postmortems 1:1 anhängen (nur dokumentierte Befehle dieser Checkliste):

  1. openclaw config validate — Konfiguration syntaktisch und semantisch gegen die CLI-Regeln prüfen.
  2. openclaw doctor — Umgebung, Pfade und typische Gateway-Voraussetzungen gesammelt ausgeben lassen.
  3. openclaw gateway status --format json — strukturierten Laufzeitstatus erfassen; bei Flatterlast sleep 2 und erneut lesen.
  4. Sekundärsonde: curl mit Authorization: Bearer $OPENCLAW_GATEWAY_TOKEN gegen http://127.0.0.1:18789/health.
  5. Port-Fingerprint: lsof -nP -iTCP:18789 -sTCP:LISTEN — PID mit JSON-Status abgleichen.
openclaw config validate openclaw doctor openclaw gateway status --format json sleep 2 openclaw gateway status --format json curl -fsS -H "Authorization: Bearer $OPENCLAW_GATEWAY_TOKEN" http://127.0.0.1:18789/health lsof -nP -iTCP:18789 -sTCP:LISTEN

Betriebshinweise: (1) JSON und lsof-PID müssen zur selben Instanz passen. (2) Bei Fehlern gateway status-Ausgabe und lsof-Zeile dem Ticket beifügen. (3) Bei Erfolg immer eine Zeile openclaw --version archivieren.

FAQ

Status-JSON wirkt gesund, externe Clients scheitern trotzdem

Zuerst direkten Loopback-curl gegen 127.0.0.1:18789 vergleichen; dann Proxys, VPN-Split und doppelte Gateway-Prozesse ausschließen.

Darf ich weitere openclaw-Unterbefehle in dieselbe Abnahme packen?

Dieser Artikel beschränkt sich bewusst auf config validate, doctor, gateway status und onboard --install-daemon. Alles andere bitte gegen die aktuelle offizielle Befehlsliste prüfen — nichts erfinden.

Wo dokumentiere ich den erfolgreichen Lauf?

Ein einziges Logfile mit Zeitstempel, openclaw --version, Node-execPath, redigiertem Token-Nachweis (nur „gesetzt ja/nein“) und der kompakten curl-Antwort reicht für die meisten Auditoren.

Fazit & Kaufhinweis: Eine Installationsroute, einheitliche Node-Pfade, Loopback 127.0.0.1:18789 und ein konsistentes OPENCLAW_GATEWAY_TOKEN sind das Fundament. Die Abnahme schließen Sie mit openclaw config validate → openclaw doctor → openclaw gateway status --format json → curl /health. Für dauerhaft erreichbare Apple-Silicon-Remote-Macs zu fairen Konditionen: Startseite, Preise, Kaufen und Hilfe — weiterhin ohne Login; ergänzend lohnt der Rückblick in den Technik-Blog zu OpenClaw-Themen.

OpenClaw-Gateway-Checks auf gemieteten Macs stabilisieren

Startseite, Preise, Kaufen, Hilfe und der Technik-Blog bleiben ohne Anmeldung nutzbar.

Jetzt kaufen Hilfe-Center