OpenClaw unter Linux installieren: VPS-Guide in 5 Minuten

Linux-Server einzurichten kann manchmal echt nervig sein, besonders wenn du dich mit Hintergrundprozessen und Abhängigkeiten herumschlagen musst. Du willst einfach nur, dass dein Tool stabil läuft, ohne stundenlang Manuals zu wälzen.

Das Gateway wird unter Linux voll unterstützt. Node.js ist die empfohlene Runtime. Bun wird für das Gateway nicht empfohlen (WhatsApp/Telegram Bugs).

Native Linux Companion Apps sind geplant. Wenn du beim Bauen helfen möchtest, sind Beiträge willkommen.

Schneller Pfad für Anfänger (VPS)

1. Installiere Node 24 (empfohlen; Node 22 LTS, aktuell 22.14+, funktioniert wegen der Kompatibilität auch noch)
2. npm i -g openclaw@latest
3. openclaw onboard --install-daemon
4. Von deinem Laptop aus: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
5. Öffne http://127.0.0.1:18789/ und füge dein Token ein

Vollständiger Linux Server Guide: Linux Server. Schritt-für-Schritt VPS Beispiel: exe.dev

Installation

• Erste Schritte
• Installation & Updates
• Optionale Flows: Bun (experimentell), Nix, Docker

Gateway

• Gateway Runbook
• Konfiguration

Gateway-Service Installation (CLI)

Verwende einen dieser Befehle:

openclaw onboard --install-daemon

Oder:

openclaw gateway install

Oder:

openclaw configure

Wähle Gateway service, wenn du dazu aufgefordert wirst.

Reparieren/Migrieren:

openclaw doctor

Systemsteuerung (systemd user unit)

OpenClaw installiert standardmäßig einen systemd user Service. Verwende einen system Service für geteilte oder Always-on-Server. Das vollständige Unit-Beispiel und Anleitungen findest du im Gateway Runbook.

Minimales Setup:

Erstelle ~/.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

[Install]
WantedBy=default.target

Aktiviere ihn:

systemctl --user enable --now openclaw-gateway[-<profile>].service

Nächste Schritte

• Gateway Runbook
• Konfiguration

AI Setup Assistant