Platforms overview
Linux-App
Der Gateway wird unter Linux vollständig unterstützt. Node ist die empfohlene Laufzeitumgebung; Bun wird nicht empfohlen (bekannte Probleme mit WhatsApp/Telegram).
Eine native Linux-Begleit-App gibt es noch nicht. Beiträge sind willkommen.
Schnellstart (VPS)
- Installieren Sie Node 24 (empfohlen) oder Node 22.19+ (LTS, weiterhin unterstützt).
npm i -g openclaw@latestopenclaw onboard --install-daemon- Auf Ihrem Laptop:
ssh -N -L 18789:127.0.0.1:18789 <user>@<host> - Öffnen Sie
http://127.0.0.1:18789/und authentifizieren Sie sich mit dem konfigurierten gemeinsamen Secret (standardmäßig Token; Passwort, wenngateway.auth.modeauf"password"gesetzt ist).
Vollständige Server-Anleitung: Linux-Server. Schritt-für-Schritt-Beispiel für einen VPS: exe.dev.
Installation
Gateway-Dienst (systemd)
Installieren Sie ihn mit einem der folgenden Befehle:
openclaw onboard --install-daemonopenclaw gateway installopenclaw configure # wählen Sie bei Aufforderung "Gateway service" ausEine vorhandene Installation reparieren oder migrieren:
openclaw doctoropenclaw gateway install erzeugt standardmäßig eine systemd-Benutzer-Unit. Vollständige
Hinweise zum Dienst, einschließlich der Variante als System-Unit für gemeinsam genutzte oder
dauerhaft aktive Hosts, finden Sie im Gateway-Betriebshandbuch.
Erstellen Sie eine Unit nur für eine benutzerdefinierte Einrichtung manuell. Minimales Beispiel für eine Benutzer-Unit
(~/.config/systemd/user/openclaw-gateway[-<profile>].service):
[Unit]Description=OpenClaw Gateway (Profil: <profile>, v<version>)After=network-online.targetWants=network-online.targetStartLimitBurst=5StartLimitIntervalSec=60 [Service]ExecStart=/usr/local/bin/openclaw gateway --port 18789Restart=alwaysRestartSec=5RestartPreventExitStatus=78TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143OOMPolicy=continueKillMode=control-group [Install]WantedBy=default.targetAktivieren Sie sie:
systemctl --user enable --now openclaw-gateway[-<profile>].serviceSpeicherdruck und Beendigungen durch den OOM-Killer
Unter Linux wählt der Kernel einen OOM-Kandidaten aus, wenn einem Host, einer VM oder einer Container-cgroup der Arbeitsspeicher ausgeht. Der Gateway ist dafür ungeeignet, da er langlebige Sitzungen und Kanalverbindungen verwaltet. Daher sorgt OpenClaw nach Möglichkeit dafür, dass kurzlebige Kindprozesse zuerst beendet werden.
Für geeignete unter Linux gestartete Kindprozesse umschließt OpenClaw den Befehl mit einem kurzen
/bin/sh-Shim, das den eigenen oom_score_adj-Wert des Kindprozesses auf 1000 erhöht und anschließend
den eigentlichen Befehl per exec ausführt. Dafür sind keine erweiterten Berechtigungen erforderlich: Ein Prozess darf
seinen eigenen OOM-Wert jederzeit erhöhen.
Abgedeckte Kindprozessbereiche:
- Vom Supervisor verwaltete Befehls-Kindprozesse
- PTY-Shell-Kindprozesse
- Kindprozesse von MCP-stdio-Servern
- Von OpenClaw gestartete Browser-/Chrome-Prozesse (über die Prozesslaufzeit des Plugin SDK)
Der Wrapper wird nur unter Linux verwendet und übersprungen, wenn /bin/sh nicht verfügbar ist oder wenn
die Umgebung des Kindprozesses OPENCLAW_CHILD_OOM_SCORE_ADJ auf 0, false, no oder
off setzt.
Überprüfen Sie einen Kindprozess:
cat /proc/<child-pid>/oom_score_adjDer erwartete Wert für abgedeckte Kindprozesse ist 1000; der Gateway-Prozess selbst
behält seinen normalen Wert (üblicherweise 0).
OOMPolicy=continue in der systemd-Unit hält den Gateway-Dienst aktiv, wenn
der OOM-Killer einen kurzlebigen Kindprozess auswählt, anstatt die gesamte
Unit als fehlgeschlagen zu markieren und alle Kanäle neu zu starten. Der fehlgeschlagene Kindprozess beziehungsweise die fehlgeschlagene Sitzung meldet
den eigenen Fehler.
Dies ersetzt keine normale Speicheroptimierung. Wenn ein VPS oder Container wiederholt
Kindprozesse beendet, erhöhen Sie das Speicherlimit, reduzieren Sie die Parallelität oder fügen Sie strengere
Ressourcenbeschränkungen hinzu (systemd MemoryMax=, Container-Speicherlimits).
