OpenClaw installieren: Vollständige Anleitung für Mac, Windows und Linux (2026)

OpenClaw installieren: Eine Schritt-für-Schritt-Anleitung

OpenClaw ist ein kostenloser, quelloffener KI-Agent, der auf deiner eigenen Hardware läuft. Diese Anleitung zeigt, wie du OpenClaw auf Mac, Windows oder Linux in etwa 15 bis 20 Minuten einrichtest und deinen ersten Chat startest.

Voraussetzungen

Bevor du anfängst, stelle sicher, dass folgendes installiert und verfügbar ist:

• Node.js Version 22 oder höher (prüfe mit node --version)
• Einen API-Schlüssel eines unterstützten Sprachmodell-Anbieters (Anthropic, OpenAI, Google oder ein lokales Modell über Ollama)
• Administratorzugang auf deinem Rechner für die Daemon-Installation

Node.js kannst du kostenlos von nodejs.org herunterladen. Wähle die aktuelle LTS-Version.

Schritt 1: OpenClaw über npm installieren

Öffne ein Terminal (Mac/Linux) beziehungsweise die PowerShell (Windows) und führe folgenden Befehl aus:

npm install -g openclaw@latest

Dieser Befehl installiert die openclaw-CLI global auf deinem System. Prüfe die Installation anschließend:

openclaw --version

Erscheint eine Versionsnummer, war die Installation erfolgreich.

Schritt 2: Den Einrichtungsassistenten starten

Der Onboarding-Assistent richtet das Konfigurationsverzeichnis ~/.openclaw/ ein und installiert den Gateway als Hintergrunddienst:

openclaw onboard --install-daemon

Das Flag --install-daemon installiert OpenClaw als Systemdienst. Auf macOS wird ein launchd-Daemon erstellt, auf Linux ein systemd-Dienst. Dadurch startet der Gateway nach jedem Neustart des Rechners automatisch.

Folge den Anweisungen im Assistenten. Du wirst nach folgenden Angaben gefragt:

• Dein bevorzugter KI-Anbieter und API-Schlüssel
• Grundlegende Einstellungen für den Agenten

Schritt 3: Das KI-Modell konfigurieren

Bearbeite die Datei ~/.openclaw/openclaw.json, um das gewünschte Sprachmodell einzustellen:

{ "agent": { "model": "anthropic/claude-opus-4-6" } }

Unterstützte Anbieter:

Wenn du ein lokales Modell über Ollama nutzen möchtest, starte Ollama zuerst mit ollama serve, bevor du den OpenClaw-Gateway startest. Lokale Modelle erfordern keinen API-Schlüssel und erzeugen keine Kosten pro Anfrage.

Schritt 4: Messaging-Kanäle verbinden

Um Messaging-Apps zu verbinden, führe aus:

openclaw channels login

Dieser Befehl öffnet ein Browserfenster, in dem du dich bei WhatsApp, Telegram, Discord, Slack, Signal, iMessage und anderen unterstützten Diensten authentifizieren kannst. Das musst du nur einmal pro Kanal tun.

Falls du OpenClaw zunächst ohne Messaging-App testen möchtest, überspringe diesen Schritt und nutze den eingebauten WebChat in der Control-UI.

Schritt 5: Den Gateway starten

Starte den OpenClaw-Gateway manuell (nach einem Neustart übernimmt der Daemon diese Aufgabe automatisch, aber nach der ersten Installation muss er einmal manuell gestartet werden):

openclaw gateway --port 18789

Öffne nun http://127.0.0.1:18789/ in deinem Browser. Dies ist die Control-UI, über die du den Agenten überwachen, den Speicher einsehen, Skills verwalten und Einstellungen anpassen kannst.

Schritt 6: Erste Nachricht senden

Wenn du einen Kanal verbunden hast, öffne die entsprechende App und sende dem Agenten eine Nachricht:

Hallo! Was kannst du tun?

Der Agent antwortet mit einer Zusammenfassung seiner aktuellen Fähigkeiten basierend auf den installierten Skills.

Falls du keinen Kanal verbunden hast, nutze den WebChat direkt in der Control-UI.

OpenClaw aktualisieren

Um auf die neueste stabile Version zu aktualisieren:

openclaw update --channel stable

Alternativ gibt es die Kanäle beta und dev für Nutzer, die frühen Zugang zu neuen Funktionen möchten.

Häufige Probleme und Lösungen

"node: command not found" Node.js ist nicht installiert oder nicht im PATH. Lade es von nodejs.org herunter und installiere Version 22 oder höher.

"EACCES: permission denied" Führe den npm-Befehl mit sudo aus oder konfiguriere npm so, dass es ein Verzeichnis mit deinen Berechtigungen verwendet. Die npm-Dokumentation erklärt die Lösung ausführlich.

Gateway startet nicht Prüfe, ob Port 18789 bereits belegt ist: lsof -i :18789. Verwende bei Bedarf --port um einen anderen Port festzulegen.

Channel-Authentifizierung schlägt fehl Melde dich ab und wieder an: openclaw channels logout && openclaw channels login.

Nächste Schritte

Sobald OpenClaw läuft, solltest du Skills installieren, die die Fähigkeiten des Agenten erweitern. Das ClawHub-Verzeichnis enthält über 5.700 Skills. Lies die Skills-Anleitung um mehr zu erfahren.

Wenn du OpenClaw in einem Docker-Container betreiben möchtest, schau in die Docker-Anleitung.

Für einen stromsparenden Dauerbetrieb zu Hause ist der Mac-Mini-Guide besonders empfehlenswert.

Häufig gestellte Fragen

Ist OpenClaw kostenlos?

Die Software ist kostenlos und MIT-lizenziert. Du zahlst nur für die API-Aufrufe des KI-Modells, in der Regel zwischen 5 und 30 Euro pro Monat. Mit lokalen Modellen über Ollama entstehen keine zusätzlichen Kosten. Mehr dazu im Artikel über die OpenClaw-Kosten.

Funktioniert OpenClaw auf Deutsch?

Ja. Du kannst den Agenten auf Deutsch ansprechen und er antwortet ebenfalls auf Deutsch, sofern das verwendete Sprachmodell Deutsch unterstützt. Claude, GPT-4 und die meisten modernen Modelle sprechen Deutsch ausgezeichnet.

Kann ich OpenClaw ohne Administratorrechte installieren?

Ja. Die Daemon-Installation erfordert erhöhte Berechtigungen, aber du kannst OpenClaw auch manuell mit openclaw gateway starten, ohne den Daemon einzurichten. Du müsstest den Gateway dann nach jedem Neustart selbst starten.

Welche Node.js-Version ist erforderlich?

Node.js 22 oder höher. Ältere Versionen werden nicht unterstützt und führen zu Fehlern beim Start.

Kann ich das KI-Modell später wechseln?

Ja. Bearbeite einfach das model-Feld in ~/.openclaw/openclaw.json und starte den Gateway neu. Alle gespeicherten Skills und Erinnerungen bleiben dabei erhalten.