Voraussetzungen

Bevor du loslegst, stelle sicher, dass dein System die Mindestanforderungen erfüllt: Node.js Version 22 oder höher, npm als Paketmanager, eine stabile Internetverbindung und mindestens einen API-Key für einen KI-Provider wie Anthropic Claude oder OpenAI. Für VPS-Deployments empfehlen sich mindestens 2 GB RAM plus eine 4 GB Swap-Datei.

Methode 1: Quick-Install (empfohlen)

Der schnellste Weg ist das offizielle Installer-Skript. Es erkennt dein Betriebssystem automatisch, prüft die Node.js-Version und startet den Onboarding-Wizard:

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

Auf Windows nutzt du PowerShell als Administrator:

curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd

Das Skript installiert OpenClaw global und führt dich durch die Konfiguration: KI-Provider auswählen, API-Key eingeben, Messenger-Plattform verbinden.

Methode 2: npm Installation

Für mehr Kontrolle kannst du OpenClaw direkt über npm installieren:

sudo npm install -g openclaw@latest
openclaw onboard --install-daemon

Das Flag --install-daemon registriert OpenClaw als Systemdienst — so überlebt der Agent Neustarts und läuft permanent im Hintergrund.

Methode 3: Docker

Ideal für Isolation und Reproduzierbarkeit:

docker pull openclaw/openclaw:latest
docker run -d --name openclaw -p 3000:3000   -v ~/.openclaw:/root/.openclaw   --env-file ~/.openclaw/.env   openclaw/openclaw:latest

Docker mountet zwei Volumes: ~/.openclaw für Konfiguration und Credentials, und ~/openclaw/workspace als Sandbox für den Agent.

Onboarding-Wizard

Nach der Installation führt dich der Wizard durch die Konfiguration. Die wichtigsten Entscheidungen: Welchen KI-Provider möchtest du nutzen? Anthropic Claude wird für die meisten Anwendungsfälle empfohlen. Welche Messenger-Plattform soll verbunden werden? WhatsApp erfordert einen QR-Code-Scan, Telegram einen Bot-Token vom BotFather.

Erste Schritte nach der Installation

Überprüfe die Installation mit diesen Befehlen:

openclaw --version    # Versionsnummer anzeigen
openclaw doctor       # Diagnose-Check
openclaw status       # Gateway-Status
openclaw dashboard    # Browser-UI öffnen

Das Web-Dashboard erreichst du standardmäßig unter http://localhost:18789. Dort kannst du Skills installieren, den Agent konfigurieren und den Chatverlauf einsehen.

Typische Probleme und Lösungen

Die häufigsten Installationsprobleme: Gateway antwortet nicht — starte mit openclaw gateway restart und prüfe die API-Keys. Port 18789 belegt — finde den Prozess mit sudo lsof -i :18789. Docker-Berechtigungsfehler — korrigiere mit sudo chown -R 1000:1000 ~/.openclaw.

Als Daemon einrichten

Für Always-On-Betrieb sollte OpenClaw als Systemdienst laufen. Das --install-daemon Flag registriert den Dienst automatisch. Ab dann startet OpenClaw bei jedem Systemstart und läuft permanent im Hintergrund.

Weitere Artikel

🦀 OpenClaw Setup gewünscht?

ClawPoint übernimmt Setup, Administration und Custom Skills. Du chattest, wir kümmern uns um den Rest.

Beratung anfragen