OpenClaw installieren: Anleitung für Anfänger

Du hast von OpenClaw gehört, willst es ausprobieren und sitzt jetzt vor deinem Terminal. Und fragst dich:

Wo fange ich an?

Kein Wunder. OpenClaw ist innerhalb weniger Monate zum am schnellsten wachsenden Open-Source-Projekt der Geschichte geworden (über 280.000 GitHub-Stars, Stand März 2026). Jeder redet darüber. Aber eine vernünftige Schritt-für-Schritt-Anleitung auf Deutsch? Die musst du erst mal finden.

Ich habe OpenClaw seit den frühen Tagen (damals hieß es noch Clawdbot) auf mehreren Rechnern installiert, konfiguriert, kaputtgemacht und wieder repariert. Mein MacBook hat das Onboarding beim ersten Mal ohne Probleme geschluckt. Mein Linux-Server nicht. Die Installation ist kein Hexenwerk. Aber es gibt ein paar Stolperfallen, die dir keiner sagt, wenn du einfach nur den Einzeiler aus der Dokumentation kopierst.

In dieser Anleitung zeige ich dir Schritt für Schritt, wie du OpenClaw installierst, einrichtest und deinen ersten KI-Agenten zum Laufen bringst. Egal ob du macOS, Linux oder Windows nutzt.

Was ist OpenClaw eigentlich?

Kurz zur Einordnung, falls du nicht genau weißt, worum es geht:

OpenClaw ist ein Open-Source-KI-Agent mit MIT-Lizenz. Gegründet wurde das Projekt im November 2025 vom Österreicher Peter Steinberger (der mittlerweile zu OpenAI gewechselt ist, das Projekt wird als Foundation weitergeführt).

Und nein:

OpenClaw ist nicht einfach ein weiteres Coding-Tool wie Claude Code oder GitHub Copilot. OpenClaw ist ein universeller KI-Agent. Das heißt, du kannst ihn über WhatsApp, Telegram, Discord, Signal oder Slack nutzen, nicht nur über die Kommandozeile.

Du fragst ihn per Nachricht, etwas zu tun, und er erledigt es. Recherche, Zusammenfassungen, Datenanalyse, Automatisierungen. Wenn du vor allem Coding-Unterstützung suchst, ist ein Vergleich der KI-Coding-Tools vielleicht hilfreicher. Aber OpenClaw kann deutlich mehr.

Im Prinzip ist es ein persönlicher KI-Assistent, den du überall anbinden kannst.

Was du für die OpenClaw-Installation brauchst

Prüfe kurz diese Punkte, bevor du anfängst:

Node.js 22 oder neuer. Das ist die wichtigste Voraussetzung. Wenn du dir unsicher bist, welche Version du hast, öffne dein Terminal und tippe node --version. Steht da etwas unter v22? Dann musst du aktualisieren. Am einfachsten geht das mit nvm (Node Version Manager):

nvm install 22

Falls du nvm noch nicht hast, findest du die Installationsanleitung auf der offiziellen GitHub-Seite.

Dein Betriebssystem. OpenClaw läuft auf:

• macOS 13 (Ventura) oder neuer
• Linux mit glibc 2.31+
• Windows nur über WSL2 (dazu gleich mehr)

Ein API-Key (optional, aber empfohlen). Du brauchst einen API-Key von einem KI-Anbieter, z. B. Anthropic (Claude), OpenAI (GPT) oder Google (Gemini). Alternativ kannst du Ollama für lokale Modelle nutzen. Das ist komplett kostenlos. Dazu später mehr.

Mehr brauchst du nicht. Los geht's!

OpenClaw installieren auf macOS und Linux

Die schnellste Variante ist der offizielle Einzeiler. Öffne dein Terminal und füge folgenden Befehl ein:

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

Das Skript lädt OpenClaw herunter, installiert es und richtet den Gateway-Dienst ein. Der Gateway läuft danach als Hintergrundprozess und kümmert sich um die Kommunikation mit den KI-Modellen.

Wenn du (verständlicherweise) ungern ein Skript aus dem Internet blind ausführst, gibt es eine Alternative über npm:

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

Beide Wege führen zum gleichen Ergebnis. Der npm-Weg gibt dir nur mehr Kontrolle darüber, was passiert.

Sobald die Installation durch ist, startet automatisch der Einrichtungsassistent:

openclaw onboard

Falls er nicht von selbst startet, tippe den Befehl einfach manuell ein. Der Assistent führt dich durch die Grundkonfiguration. API-Keys, Modellauswahl und so weiter.

OpenClaw installieren unter Windows (WSL2)

Hier wird es etwas frickeliger. Falls du hauptsächlich mit Windows arbeitest, musst du einen kleinen Umweg nehmen.

OpenClaw läuft unter Windows nicht direkt. Du brauchst WSL2 (Windows Subsystem for Linux). Falls du WSL2 noch nicht eingerichtet hast, öffne PowerShell als Administrator und tippe:

wsl --install

Danach startest du deinen Rechner neu und öffnest das WSL-Terminal (standardmäßig Ubuntu). Ab hier ist die Installation identisch mit Linux:

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

OpenClaw einrichten (API-Keys und Modell wählen)

Nach der Installation hast du zwei Dinge zu tun. Einen API-Key hinterlegen und ein Modell auswählen.

API-Key einrichten

Der openclaw onboard-Assistent fragt dich direkt danach. Du kannst aber auch nachträglich die Konfigurationsdatei bearbeiten (alle Optionen findest du in der offiziellen Dokumentation):

~/.openclaw/openclaw.json

OpenClaw unterstützt mittlerweile ziemlich viele Anbieter:

• Anthropic (Claude Opus 4.5, Sonnet 4.5)
• OpenAI (GPT-Modelle)
• Google (Gemini)
• Ollama (lokale Modelle, komplett kostenlos)
• OpenRouter, Mistral, DeepSeek, Groq und weitere

Modell wählen

Meine Empfehlung für den Einstieg:

Fang mit Claude Sonnet 4.5 an, wenn du Qualität willst. Das Modell liefert bei den meisten Aufgaben die besten Ergebnisse und ist preislich im Rahmen (ca. 3 $ pro Million Input-Token).

Wenn du erstmal kein Geld ausgeben willst, installier Ollama und nutz ein lokales Open-Source-Modell. Ehrlich gesagt merkt man den Qualitätsunterschied zu Claude oder GPT bei komplexeren Aufgaben deutlich. Aber zum Ausprobieren und für einfachere Sachen reicht es.

Messaging-Kanäle verbinden (optional)

Genau das unterscheidet OpenClaw von anderen KI-Agenten:

Du kannst es direkt mit WhatsApp, Telegram, Discord, Signal oder Slack verbinden. Das machst du entweder über den Einrichtungsassistenten oder über das Dashboard:

openclaw dashboard

Dieser Befehl öffnet eine Oberfläche im Browser, über die du Kanäle verbinden und konfigurieren kannst. Ist auf dem ersten Blick etwas unübersichtlich, aber die Telegram-Anbindung hatte ich in unter 5 Minuten eingerichtet.

Erste Schritte mit OpenClaw

Alles eingerichtet? Dann probier es aus.

Wenn du einen Messaging-Kanal verbunden hast, schreib deinem OpenClaw-Bot einfach eine Nachricht. Zum Beispiel über Telegram:

"Fasse mir die wichtigsten KI-Nachrichten der letzten Woche zusammen."

OpenClaw nutzt dann das konfigurierte Modell, recherchiert (falls du Web-Zugriff aktiviert hast) und antwortet dir direkt im Chat.

Du kannst OpenClaw aber auch über die Kommandozeile nutzen. Starte einfach eine Sitzung:

openclaw chat

Probier erstmal etwas Einfaches aus. Frag nach einer Zusammenfassung, lass dir einen Text umschreiben oder bitte um eine Analyse eines PDFs. So bekommst du ein Gefühl dafür, was funktioniert und wo die Grenzen liegen.

Die Grenzen merkst du schnell. OpenClaw halluziniert genauso wie jedes andere KI-Tool, wenn du es mit vagen Anfragen fütterst. Je konkreter deine Anweisungen, desto besser die Ergebnisse. Falls du dir einen breiteren Überblick verschaffen willst, schau dir meine Übersicht der besten KI-Tools an.

Häufige Fehler bei der Installation (und wie du sie löst)

Jeden dieser Fehler habe ich mindestens einmal selbst gemacht. Hier die häufigsten Probleme und was du dagegen tun kannst:

"openclaw: command not found"

Der Klassiker (hatte ich auch). Nach der Installation findet dein Terminal den Befehl nicht. Das liegt fast immer am PATH. Schließe das Terminal und öffne es neu. Falls das nicht hilft, füge den Installationspfad manuell zu deiner .bashrc oder .zshrc hinzu.

Node.js-Version zu alt

Wenn du eine Fehlermeldung bekommst, die sich auf Node.js bezieht, prüfe deine Version mit node --version. Alles unter v22 ist zu alt:

nvm install 22

Build-Werkzeuge fehlen (Linux)

Unter Linux brauchst du eventuell zusätzliche Pakete. Wenn der Build fehlschlägt, installiere:

sudo apt install build-essential git python3

Gateway-Port ist belegt

Wenn der Gateway-Dienst nicht startet, läuft wahrscheinlich schon etwas anderes auf dem gleichen Port. Du kannst den Port in der openclaw.json ändern oder mit openclaw gateway status prüfen, was los ist.

Die Konfiguration ist kaputt

Hast du die openclaw.json so verbogen, dass nichts mehr geht? Kenn ich. Die Lösung:

openclaw doctor --fix

Dieser Befehl analysiert deine Konfiguration und repariert, was reparierbar ist.

WSL2 ist langsam

Wie schon gesagt. Arbeite in nativen WSL-Verzeichnissen, nicht in /mnt/c/.... Das macht einen enormen Unterschied.

Sicherheitshinweise, die du kennen solltest

Kurzer Reality-Check.

OpenClaw ist ein starkes Projekt mit einer aktiven Community. Aber es ist auch noch jung. Und das bringt Sicherheitsrisiken mit sich.

Im Februar 2026 wurde eine kritische Sicherheitslücke entdeckt (CVE-2026-25253), die es Angreifern ermöglichte, per Mausklick Schadcode auszuführen. Die Lücke wurde gepatcht, aber sie zeigt, warum du OpenClaw immer auf dem neuesten Stand halten solltest.

openclaw update --channel stable

Dazu kommt, dass eine Studie ergeben hat, dass rund 36 % der Skills auf ClawHub (dem Marktplatz für OpenClaw-Erweiterungen) Prompt Injections enthalten. Cisco, Microsoft und Kaspersky haben ebenfalls Sicherheitswarnungen veröffentlicht. Laut Sicherheitsforschern sind über 135.000 OpenClaw-Instanzen ungeschützt im Internet erreichbar.

Meine Sicherheitsregeln für OpenClaw:

1. Immer die neueste Version nutzen (klingt banal, aber CVE-2026-25253 hat gezeigt, warum das so wichtig ist)
2. Keine sensiblen Daten (Passwörter, Kundendaten, interne Dokumente) an den Agenten geben
3. Skills aus ClawHub vor der Installation prüfen, nicht blind installieren
4. Bei automatisierten Agenten ein Ausgabenlimit beim API-Anbieter setzen

Was kostet OpenClaw?

Die Software selbst kostet nichts. OpenClaw ist komplett Open Source unter MIT-Lizenz.

Die eigentlichen Kosten entstehen durch die KI-Modelle, die du im Hintergrund nutzt. Die hast du selbst in der Hand.

Typische Kosten bei normaler Nutzung liegen bei 5 bis 30 $ pro Monat für API-Aufrufe (je nach Modell und Intensität). Das ist vergleichbar mit einem ChatGPT-Plus-Abo.

Wenn du komplett kostenlos fahren willst, installier Ollama und nutz lokale Modelle. Dann zahlst du wirklich gar nichts (abgesehen vom Strom für deinen Rechner).

Fazit

Das war's! Du hast OpenClaw installiert, konfiguriert und weißt, worauf du achten musst.

Die Sicherheitswarnungen klingen vielleicht abschreckend, aber sie sind kein Grund, OpenClaw links liegen zu lassen. Regelmäßig aktualisieren, keine sensiblen Daten reinkippen und nicht jede Erweiterung aus dem ClawHub blind installieren. Dann bist du auf der sicheren Seite.

Wenn du tiefer einsteigen willst, schau dir als Nächstes die Skill-Entwicklung an. Eigene Skills zu bauen hat bei mir echt einen Aha-Moment ausgelöst, weil du ab da merkst, wie flexibel das System ist. Falls du dir nicht sicher bist, ob OpenClaw das richtige Tool für dich ist, hilft dir mein Vergleich der besten OpenClaw-Alternativen bei der Entscheidung.