OpenClaw DACH
Alle Guides

OpenClaw auf Linux einrichten

Anfänger10-15 Minuten

# OpenClaw für Linux -- Anfänger-Anleitung (Deutsch)

Zielgruppe: Linux-Anfänger (Ubuntu, Debian, Fedora, etc.)

Dauer: 10-15 Minuten

Schwierigkeit: Anfänger

Getestet auf: Ubuntu 22.04 LTS, Ubuntu 24.04 LTS, Debian 12

Voraussetzungen

  • Linux installiert (Ubuntu, Debian, Fedora, Arch, etc.)
  • Zugang zum Terminal (Du kannst Befehle eingeben)
  • Sudo-Rechte (Du kannst sudo Befehle ausführen)
  • Internet-Verbindung (Für Download + API-Calls)

Falls du gerade erst Linux installiert hast und Terminal nicht findest: [Siehe Schritt 1](#schritt-1-terminal-öffnen)

Schritt 1: Terminal öffnen

Das Terminal ist die Kommandozeile auf Linux. Hier geben wir Befehle ein.

Ubuntu/Debian Desktop (GNOME):

  1. Drücke Windows-Taste (oder Super-Taste) auf deiner Tastatur

- Ein Suchfeld öffnet sich

  1. Tippe: terminal (klein)

- Du siehst ein Icon mit schwarzem Fenster

  1. Klick drauf oder drücke Enter

- Schwarz-weiß Terminal öffnet sich

  1. Du siehst etwas wie:

```

user@ubuntu:~$

```

Perfekt! Das ist dein Terminal.

Fedora/RHEL (falls installiert):

  1. Drücke Windows-Taste
  2. Tippe: terminal
  3. Klick auf das Icon

Gleich wie Ubuntu.

Falls Terminal nicht sichtbar:

Alternativ: Drücke Strg + Alt + T auf deiner Tastatur

Das öffnet Terminal direkt (bei den meisten Linux-Distributionen).

Schritt 2: Node.js überprüfen

Wir prüfen erst, ob Node.js schon installiert ist.

Im Terminal, tippe:

node --version

Drücke Enter.

Was passiert?

SZENARIO A: Node.js IST installiert

Du siehst:

v22.11.0

oder eine andere Nummer >= 20.

Super! Du kannst direkt zu Schritt 4 springen.

SZENARIO B: Node.js ist NICHT installiert

Du siehst:

command not found: node

oder

The program 'node' is currently not installed

Kein Problem! Wir installieren es jetzt. Fahre mit Schritt 3 fort.

Schritt 3: Node.js installieren

Es gibt mehrere Wege. Der einfachste:

Option A: Paket-Manager (Ubuntu/Debian)

Im Terminal:

sudo apt update

Drücke Enter. Es fragt vielleicht nach deinem Passwort -- tippe es ein (wird nicht angezeigt).

Danach:

sudo apt install nodejs npm -y

Drücke Enter.

Das dauert 2-3 Minuten. Am Ende siehst du:

Processing triggers for...

Option B: Paket-Manager (Fedora/RHEL)

Falls du Fedora/RHEL nutzt:

sudo dnf install nodejs npm -y

Drücke Enter.

Option C: Node Version Manager (nvm) -- für Fortgeschrittene

Falls du mehrere Node-Versionen brauchst:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

Danach Terminal schließen und neu öffnen.

Dann:

nvm install 22
nvm use 22

Schritt 3.1: Überprüfe Node.js

Im Terminal:

node --version

Du solltest sehen:

v22.x.x

oder

v20.x.x

Perfekt! Node.js läuft.

Schritt 4: OpenClaw installieren

Jetzt geht's richtig los!

Im Terminal:

curl -fsSL https://openclaw.ai/install.sh | bash

Drücke Enter.

Was passiert:

Das Installations-Skript lädt herunter und OpenClaw wird installiert. Das dauert 3-5 Minuten.

Du siehst viel Text -- das ist normal.

Am Ende:

✓ Installation complete!

oder

OpenClaw v1.5.2 installed successfully

Glückwunsch!

Schritt 5: OpenClaw einrichten (Onboard)

Der Assistent stellt dir Fragen:

Im Terminal:

openclaw onboard --install-daemon

Drücke Enter.

Frage 1: Welcher KI-Anbieter?

Du siehst:

Welcher KI-Anbieter möchtest du nutzen?

  ▶ Anthropic (Claude)
    OpenAI (ChatGPT)
    Google (Gemini)
    OpenRouter

Pfeiltasten (Auf/Ab) drücken um zu wählen.

Enter um zu bestätigen.

Empfehlung: Wenn kein Abo: Google (Gemini) (kostenlos)

Frage 2: API-Key

Je nachdem, was du wählst:

Für Anthropic (Claude):

  • Öffne Browser: https://console.anthropic.com
  • Klick "API Keys"
  • "Create Key" -> Code kopieren
  • Im Terminal Strg + V um einzufügen
  • Enter

Für OpenAI:

  • Browser: https://platform.openai.com/account/api-keys
  • "Create new secret key" -> Kopieren
  • Terminal: Strg + V
  • Enter

Für Google (kostenlos):

  • Browser öffnet sich automatisch
  • Du meldest dich an
  • Erlaubnis geben
  • Fertig!

Frage 3: Messaging-Kanäle

Messaging-Kanäle:

  ☑ WhatsApp
  ☑ Telegram
  ☐ Discord

Pfeiltaste + Leertaste zum Ein/Ausschalten.

Empfehlung: WhatsApp (am einfachsten)

Frage 4: Gateway starten?

Frage: "Gateway als Daemon installieren?" oder "Install as service?"

Antwort: Ja

Fertig!

✓ OpenClaw Gateway installed successfully!
✓ Daemon configured
✓ Ready to go!

Schritt 6: Dashboard öffnen

Im Terminal:

openclaw dashboard

Drücke Enter.

Dein Browser öffnet sich mit:

http://localhost:18789

Falls nicht automatisch: Öffne deinen Browser und gib diese Adresse manuell ein.

Schritt 7: Test-Nachricht

  1. Klick ins Chat-Fenster
  2. Schreib: "Hallo!"
  3. Enter

OpenClaw antwortet!

Schritt 8: WhatsApp verbinden (Optional)

Im Terminal:

openclaw channels login --channel whatsapp

Ein QR-Code erscheint.

Mit Handy WhatsApp-Kamera: Einstellungen -> Verknüpfte Geräte -> Gerät hinzufügen -> QR-Code scannen.

Fertig!

Häufige Linux-Fehler und Lösungen

Fehler 1: "curl: command not found"

Problem: curl ist nicht installiert

Lösung (Ubuntu/Debian):

sudo apt install curl -y

Lösung (Fedora):

sudo dnf install curl -y

Fehler 2: "Permission denied" beim Ausführen

Problem: Das Installations-Skript darf nicht ausgeführt werden

Lösung:

bash <(curl -fsSL https://openclaw.ai/install.sh)

Statt mit | (pipe) nutzen wir Substitution.

Fehler 3: "command not found: openclaw"

Problem: Nach Installation funktioniert openclaw nicht

Lösung:

source ~/.bashrc

oder schließ Terminal und öffne neu.

Fehler 4: "npm: command not found"

Problem: npm ist nicht installiert (nur Node.js)

Lösung (Ubuntu/Debian):

sudo apt install npm -y

Lösung (Fedora):

sudo dnf install npm -y

Fehler 5: "QR-Code wird nicht angezeigt"

Problem: openclaw channels login --channel whatsapp zeigt nichts

Lösung:

openclaw gateway status

Falls nicht läuft:

openclaw gateway restart

Dann nochmal versuchen.

Fehler 6: "Gateway läuft nicht / port 18789 ist belegt"

Problem: localhost:18789 funktioniert nicht

Lösung:

sudo lsof -i :18789

Zeigt, wer Port 18789 nutzt. Falls was anderes läuft:

openclaw gateway --port 19789

(Anderer Port)

Fehler 7: "systemd service not working"

Problem: OpenClaw startet nicht nach Boot

Lösung:

systemctl --user status openclaw

Falls nicht läuft:

systemctl --user restart openclaw

Falls immer noch nicht:

systemctl --user enable openclaw

Nützliche Terminal-Befehle

Dashboard öffnen

openclaw dashboard

Status prüfen

openclaw gateway status

Neu starten

openclaw gateway restart

Stoppen

openclaw gateway stop

Kanäle anzeigen

openclaw channels status

Modelle anzeigen

openclaw models list

Selbst-Diagnose

openclaw doctor

Logs anschauen (für Probleme)

journalctl --user -u openclaw -f

Drücke Strg + C um zu stoppen.

OpenClaw deinstallieren (falls nötig)

npm uninstall -g openclaw

Browser-Tipps

Falls localhost:18789 nicht funktioniert:

  1. Verschiedene Browser testen:

- Firefox: firefox http://localhost:18789

- Chrome: google-chrome http://localhost:18789

- Chromium: chromium http://localhost:18789

  1. localhost vs. 127.0.0.1:

- Probier: http://127.0.0.1:18789

  1. Firewall prüfen:

```bash

sudo ufw status

```

Falls aktiv:

```bash

sudo ufw allow 18789

```

Alles funktioniert?

Gratuliere! OpenClaw auf Linux funktioniert!

Nächste Schritte:

  1. Dashboard erkunden
  2. Telegram/Discord verbinden (optional)
  3. Skills installieren (optional)
  4. Nutzen und Spass haben!

Immer noch Probleme?

Option 1: Selbst-Hilfe

  • Siehe "Häufige Fehler" oben
  • Terminal schließen und neu öffnen
  • PC neu starten

Option 2: Support

  • E-Mail: support@markusstoeger.com
  • Beschreib: Linux-Version (Ubuntu 22.04? etc.)
  • Kopier Fehler-Nachricht

Option 3: Managed Hosting

  • Keine Lust auf Terminal?
  • 19 Euro/Monat, wir machen alles
  • 7 Tage kostenlos
  • -> openclaw.markusstoeger.com

Linux-Distribution spezifische Tipps

Ubuntu 22.04 / 24.04 (Empfohlen)

  • Standard-Installation funktioniert perfekt
  • Node.js: sudo apt install nodejs npm

Debian 12

  • Gleich wie Ubuntu
  • Eventuell neuere Node.js von NodeSource nötig:

```bash

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

sudo apt install nodejs

```

Fedora 39+ / RHEL 9+

  • sudo dnf install nodejs npm
  • Firewall: sudo firewall-cmd --add-port=18789/tcp --permanent

Arch Linux

  • sudo pacman -S nodejs npm
  • AUR (optional): yay -S openclaw-bin

CentOS / Stream

  • sudo dnf install nodejs npm
  • Eventuell: sudo dnf install gcc g++ make python3

Sicherheits-Tipps für Linux

1. Firewall nur auf notwendige Ports öffnen

sudo ufw allow 18789
sudo ufw default deny incoming
sudo ufw default allow outgoing

2. OpenClaw User (nicht als root laufen!)

openclaw doctor

Sollte zeigen, dass es als $USER läuft, nicht root.

3. API-Keys schützen

chmod 600 ~/.openclaw/config.json

4. Regelmässig updaten

npm update -g openclaw

Version: 1.0

Letzte Aktualisierung: 21. März 2026

Sprache: Deutsch (Austria/Germany)

Schwierigkeit: Anfänger

Getestet auf: Ubuntu 24.04 LTS, Debian 12, Fedora 39

Viel Spass mit OpenClaw auf Linux!

Zu kompliziert? Wir machen das für dich.

Managed Hosting: In 60 Sekunden fertig. 7 Tage kostenlos.

7 Tage kostenlos testen