Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Gateway wird unter Linux vollständig unterstützt. Node ist die empfohlene Runtime. Bun wird für den Gateway nicht empfohlen (WhatsApp-/Telegram-Fehler). Native Linux-Begleit-Apps sind geplant. Beiträge sind willkommen, wenn Sie beim Aufbau einer solchen App helfen möchten.

​
Schnellstart für Einsteiger (VPS)

  1. Installieren Sie Node 24 (empfohlen; Node 22 LTS, derzeit 22.16+, funktioniert aus Kompatibilitätsgründen weiterhin)
  2. npm i -g openclaw@latest
  3. openclaw onboard --install-daemon
  4. Von Ihrem Laptop aus: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Öffnen Sie http://127.0.0.1:18789/ und authentifizieren Sie sich mit dem konfigurierten gemeinsamen Secret (standardmäßig Token; Passwort, wenn Sie gateway.auth.mode: "password" festlegen)
Vollständige Linux-Server-Anleitung: Linux-Server. Schritt-für-Schritt-VPS-Beispiel: exe.dev

​
Installation

​
Gateway

​
Gateway-Dienstinstallation (CLI)

Verwenden Sie eine dieser Optionen: 
openclaw onboard --install-daemon
Oder: 
openclaw gateway install
Oder: 
openclaw configure
Wählen Sie bei der Aufforderung Gateway-Dienst aus. Reparieren/migrieren: 
openclaw doctor

​
Systemsteuerung (systemd-Benutzereinheit)

OpenClaw installiert standardmäßig einen systemd-Dienst für den Benutzer. Verwenden Sie einen System-Dienst für gemeinsam genutzte oder dauerhaft laufende Server. openclaw gateway install und openclaw onboard --install-daemon erzeugen bereits die aktuelle kanonische Einheit für Sie; schreiben Sie eine nur dann manuell, wenn Sie eine benutzerdefinierte System-/Dienstmanager- Einrichtung benötigen. Die vollständige Dienstanleitung finden Sie im Gateway-Runbook. Minimale Einrichtung: Erstellen Sie ~/.config/systemd/user/openclaw-gateway[-<profile>].service: 
[Unit]
Description=OpenClaw Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/openclaw gateway --port 18789
Restart=always
RestartSec=5
TimeoutStopSec=30
TimeoutStartSec=30
SuccessExitStatus=0 143
KillMode=control-group

[Install]
WantedBy=default.target
Aktivieren Sie sie: 
systemctl --user enable --now openclaw-gateway[-<profile>].service

​
Speicherdruck und OOM-Kills

Unter Linux wählt der Kernel ein OOM-Opfer aus, wenn einer Host-, VM- oder Container-cgroup der Speicher ausgeht. Der Gateway kann ein ungünstiges Opfer sein, weil er langlebige Sitzungen und Channel-Verbindungen besitzt. OpenClaw gewichtet daher nach Möglichkeit transiente Kindprozesse so, dass sie vor dem Gateway beendet werden. Für geeignete Linux-Kindprozesse startet OpenClaw den Kindprozess über einen kurzen /bin/sh-Wrapper, der den eigenen oom_score_adj des Kindprozesses auf 1000 erhöht und dann den eigentlichen Befehl per exec startet. Dies ist ein unprivilegierter Vorgang, weil der Kindprozess nur seine eigene Wahrscheinlichkeit erhöht, durch den OOM-Killer beendet zu werden. Abgedeckte Kindprozessoberflächen umfassen:
  • vom Supervisor verwaltete Befehlskindprozesse,
  • PTY-Shell-Kindprozesse,
  • MCP-stdio-Server-Kindprozesse,
  • von OpenClaw gestartete Browser-/Chrome-Prozesse.
Der Wrapper ist nur für Linux verfügbar und wird übersprungen, wenn /bin/sh nicht verfügbar ist. Er wird auch übersprungen, wenn die Kindprozess-Umgebung OPENCLAW_CHILD_OOM_SCORE_ADJ=0, false, no oder off setzt. So überprüfen Sie einen Kindprozess: 
cat /proc/<child-pid>/oom_score_adj
Der erwartete Wert für abgedeckte Kindprozesse ist 1000. Der Gateway-Prozess sollte seinen normalen Wert behalten, üblicherweise 0. 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 stärkere Ressourcenkontrollen wie systemd MemoryMax= oder Speicherlimits auf Container-Ebene hinzu.

​
Verwandte Themen