OpenClaw auf Linux einrichten

Zielgruppe: Absolute Anfänger — keine Terminal-Erfahrung nötig

Dauer: 15 Minuten (+ optional 30-60 Min Skills)

Schwierigkeit: Anfänger

Getestet auf: Ubuntu 22.04+ LTS, Debian 12, Fedora 39

Version: v3 (endgültig validiert)

⚠️ Sicherheitshinweis: OpenClaw hat Zugriff auf Dateien und kann Befehle ausführen. Diese Anleitung funktioniert auf deinem Mac/PC — wir empfehlen aber die Installation auf einem VPS oder einem separaten Gerät durchzuführen.

Schritt 1: Terminal öffnen

Ubuntu/Debian Desktop:

1. Drücke Windows-Taste (oder Super)
2. Tippe: terminal
3. Klick auf das Icon oder drücke Enter

Alternative: Drücke Strg + Alt + T

Ein schwarzes Fenster öffnet sich — das ist Terminal.

Schritt 2: Node.js + NPM installieren

Im Terminal, tippe:

sudo apt update && sudo apt install -y nodejs npm

(Für Fedora/RHEL, tippe stattdessen: sudo dnf install -y nodejs npm)

Drücke Enter. Es könnte nach deinem Passwort fragen.

Das dauert 2-3 Minuten.

Schritt 3: OpenClaw installieren

Im Terminal:

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

Drücke Enter.

Installation läuft 3-5 Minuten. Am Ende siehst du:

✓ Installation complete!

Schritt 4: Konfigurieren

Im Terminal:

openclaw onboard

Drücke Enter.

Hinweis: openclaw onboard ist der vollständige Ersteinrichtungs-Assistent. Wenn du nur bestimmte Einstellungen ändern möchtest (z.B. Channels oder Model), kannst du später openclaw configure verwenden.

FENSTER 1: Gateway-Ort

Where will the Gateway run?
● Local (this machine)
○ Remote (info-only)

Local ist schon markiert. Drücke Enter.

FENSTER 2: Was möchtest du konfigurieren?

Select sections to configure

● Workspace
○ Model
○ Web tools
○ Gateway
○ Daemon
○ Channels (Link WhatsApp/Telegram/etc)
○ Skills
○ Health check
○ Continue

Der Cursor (●) steht auf Workspace. Navigiere mit der Pfeiltaste (↓) nach unten zu Model und drücke Enter.

FENSTER 3: KI-Anbieter wählen

Model/auth provider

○ OpenAI (ChatGPT)
○ Anthropic (Claude)
○ Google (Gemini)
○ vLLM (Local)
... (viele mehr)

OAuth (kostenlos mit Abo) vs API-Key (kostenpflichtig):

OAuth — KOSTENLOS mit bestehendem Abo

• OpenAI: ChatGPT-Abo (€20/Monat)
• Anthropic (Claude): Claude-Abo (€20/Monat)

Du zahlst NICHT extra — OpenClaw nutzt dein bestehendes Abo.

API-Key — KOSTENPFLICHTIG

• Google, andere: Kosten Geld pro API-Call

Anfänger-Empfehlung:

Wenn du ChatGPT-Abo hast: Wähle OpenAI

Wenn du Claude-Abo hast: Wähle Anthropic

Markiere mit Pfeiltaste und drücke Enter.

FENSTER 4: OAuth-Login

Dein Browser öffnet sich.

Für OpenAI:

1. Melde dich mit ChatGPT-Konto an
2. Gib OpenClaw Erlaubnis
3. Browser schließt automatisch
4. Terminal zeigt: "Auth successful"

FENSTER 2 (zurück): Weitere Konfiguration?

Select sections to configure

● Workspace
○ Model (fertig)
○ Web tools
○ Gateway
○ Daemon
○ Channels (WhatsApp/Telegram/etc)
○ Skills
○ Health check
○ Continue

Optionen:

Option A: Nur Dashboard (schnell)

• Markiere Continue und drücke Enter

Option B: WhatsApp verbinden (10 Min mehr)

• Markiere Channels und drücke Enter
• Siehe unten

Option C: Skills installieren (30-60+ Min, optional)

• Warnung: Dauert lange!
• Viele können fehlschlagen — NORMAL

(Optional) WhatsApp verbinden

Falls du Channels wählst:

FENSTER 3: Channel-Status

Du siehst:

Channel status

Telegram: needs token
WhatsApp (default): not linked ← Das ändern wir
Discord: needs token
...

Markiere WhatsApp und drücke Enter.

FENSTER 4-7: WhatsApp Setup

(Gleich wie Mac/Windows)

1. Configure/link wählen
2. WhatsApp wählen
3. QR-Code mit Handy scannen (WhatsApp → Verknüpfte Geräte)
4. Deine Nummer eingeben (+43...)
5. Fertig!

FENSTER 2 (zurück): Continue

Markiere Continue und drücke Enter.

Schritt 5: Dashboard öffnen

Im Terminal:

openclaw dashboard

Drücke Enter.

Dein Browser öffnet sich mit:

http://127.0.0.1:18789/

Du siehst das Chat-Fenster!

Schritt 6: Test-Nachricht

1. Klick ins Chat-Fenster
2. Tippe: "Hallo!"
3. Drücke Enter

Du bekommst eine Antwort!

Schritt 7: Updates

Im Dashboard:

Update available: v2026.3.13

Klick drauf. OpenClaw wird aktualisiert (30 Sekunden).

Schritt 8: WhatsApp nutzen

Falls verbunden:

Öffne WhatsApp auf deinem Handy und schreib:

"Was kannst du tun?"

OpenClaw antwortet direkt!

Schritt 9: Telegram nutzen (optional)

Falls du Telegram verbunden hast, gibt es einen wichtigen Extra-Schritt: OpenClaw muss bestätigen, dass es dir vertraut.

Telegram Bot erstellen (BotFather)

Falls du noch keinen Bot hast:

1. Öffne Telegram und suche nach @BotFather
2. Schreib /newbot
3. Gib deinem Bot einen Namen (z.B. "Mein Assistent")
4. Gib ihm einen Benutzernamen — muss auf _bot enden (z.B. mein_assistent_bot)
5. Du bekommst einen Token (sieht aus wie 123456789:ABC-DEF...)
6. Diesen Token beim openclaw onboard unter Channels → Telegram einfügen

Ersten Kontakt genehmigen

Wenn du deinen Bot zum ersten Mal anschreibst, bekommst du im Terminal einen Pairing-Code. Bestätige ihn:

openclaw pairing approved telegram <CODE>

Ab dann antwortet OpenClaw direkt in Telegram.

Häufige Linux-Fehler & Lösungen

Fehler 1: "curl: command not found"

Lösung (Ubuntu/Debian):

sudo apt install curl -y

Lösung (Fedora):

sudo dnf install curl -y

Fehler 2: "command not found: openclaw"

Lösung:

source ~/.bashrc

Oder: Terminal schließen und neu öffnen.

Fehler 3: "Permission denied"

Lösung:

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

Fehler 4: "localhost:18789 funktioniert nicht"

Lösung (im Terminal):

openclaw gateway restart

Warte 5 Sekunden, versuche nochmal.

Fehler 5: "WhatsApp not found" beim Channels-Setup

Das ist normal.

Versuche nochmal: openclaw configure → Channels

Fehler 6: "Skills installation fehlgeschlagen"

Das ist NORMAL! OpenClaw funktioniert trotzdem perfekt.

Nützliche Terminal-Befehle

Gateway \& Status

openclaw dashboard              # Dashboard im Browser öffnen
openclaw gateway status         # Ist OpenClaw gestartet?
openclaw gateway restart        # Neu starten (löst die meisten Probleme)
openclaw gateway stop           # Stoppen
openclaw gateway start          # Starten
openclaw gateway run            # Im Vordergrund starten (mit Live-Logs)
openclaw status                 # Channel-Status und letzte Sessions anzeigen
openclaw health                 # Gateway-Gesundheit abrufen
openclaw --help                 # Alle verfügbaren Befehle

Diagnose \& Fehlersuche

openclaw doctor                 # Gesundheitscheck — prüft alles und zeigt Probleme
openclaw doctor --repair        # Wie doctor, versucht Probleme automatisch zu beheben
openclaw logs --follow          # Live-Logs anschauen (Strg+C zum Stoppen)
openclaw logs --follow --json   # Logs im JSON-Format (für Entwickler)
openclaw tui                    # Terminal-UI — Chat direkt im Terminal

Exec Approvals (Tool-Berechtigungen)

openclaw approvals get                               # Aktuelle Berechtigungen anzeigen
openclaw approvals allowlist add "/bin/bash"         # Bash freigeben
openclaw approvals allowlist add "/usr/bin/python3"  # Python freigeben

Hinweis: Wenn dein Assistent keine Terminal-Befehle ausführen kann, liegt es meist an fehlenden Exec Approvals. Starte mit openclaw approvals get und openclaw doctor.

Channels (WhatsApp, Telegram, Discord)

openclaw channels status        # Verbindungsstatus aller Channels
openclaw channels logs          # Channel-Logs anzeigen
openclaw configure              # Channels neu einrichten oder verbinden

Sessions \& Agents

openclaw sessions list          # Gespeicherte Sessions anzeigen
openclaw agents list            # Alle konfigurierten Agenten anzeigen

Skills \& Updates

openclaw skills list            # Installierte Skills anzeigen
openclaw skills search <name>   # Neuen Skill suchen
openclaw update                 # OpenClaw aktualisieren

Sicherheit \& Backup

openclaw security audit         # Sicherheits-Audit durchführen
openclaw backup create          # Backup erstellen
openclaw backup verify          # Backup prüfen

Nützliches für Fortgeschrittene

openclaw memory search <query>  # In Memory-Dateien suchen
openclaw models list            # Verfügbare KI-Modelle anzeigen
openclaw message send --target +43... --message "Test"  # Nachricht senden
openclaw docs                   # Dokumentation durchsuchen

Glückwunsch!

Du hast jetzt einen KI-Assistenten auf Linux!

• Im Browser: http://127.0.0.1:18789/
• Optional WhatsApp/Telegram
• Auto-Updates