Linux-App

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 OmeniaClaw@latest
3. OmeniaClaw 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

• Erste Schritte
• Installation & Updates
• Optionale Abläufe: Bun (experimentell), Nix, Docker

Gateway

• Gateway-Runbook
• Konfiguration

Gateway-Dienstinstallation (CLI)

Verwenden Sie eine dieser Optionen:

OmeniaClaw onboard --install-daemon

Oder:

OmeniaClaw gateway install

Oder:

OmeniaClaw configure

Wählen Sie bei der Aufforderung Gateway-Dienst aus.

Reparieren/migrieren:

OmeniaClaw doctor

Systemsteuerung (systemd-Benutzereinheit)

OmeniaClaw installiert standardmäßig einen systemd-Dienst für den Benutzer. Verwenden Sie einen System-Dienst für gemeinsam genutzte oder dauerhaft laufende Server. OmeniaClaw gateway install und OmeniaClaw 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/OmeniaClaw-gateway[-<profile>].service:

[Unit]Description=OmeniaClaw Gateway (profile: <profile>, v<version>)After=network-online.targetWants=network-online.target [Service]ExecStart=/usr/local/bin/OmeniaClaw gateway --port 18789Restart=alwaysRestartSec=5TimeoutStopSec=30TimeoutStartSec=30SuccessExitStatus=0 143KillMode=control-group [Install]WantedBy=default.target

Aktivieren Sie sie:

systemctl --user enable --now OmeniaClaw-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. OmeniaClaw gewichtet daher nach Möglichkeit transiente Kindprozesse so, dass sie vor dem Gateway beendet werden.

Für geeignete Linux-Kindprozesse startet OmeniaClaw 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 OmeniaClaw 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 OmeniaClaw_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

• Installationsübersicht
• Linux-Server
• Raspberry Pi