Skip to main content

​
Installation

Bereits Erste Schritte befolgt? Dann sind Sie startklar — diese Seite ist für alternative Installationsmethoden, plattformspezifische Anleitungen und Wartung.

​
Systemanforderungen

  • Node 22+ (das Installationsskript installiert es, falls es fehlt)
  • macOS, Linux oder Windows
  • pnpm nur, wenn Sie aus dem Quellcode bauen
Unter Windows empfehlen wir dringend, OpenClaw unter WSL2 auszuführen.

​
Installationsmethoden

Das Installationsskript ist der empfohlene Weg zur Installation von OpenClaw. Es übernimmt Node-Erkennung, Installation und Onboarding in einem Schritt.

Installer script

Lädt die CLI herunter, installiert sie global über npm und startet den Onboarding-Assistenten.
Das war’s — das Skript übernimmt Node-Erkennung, Installation und Onboarding.Um das Onboarding zu überspringen und nur das Binary zu installieren:
Für alle Flags, Umgebungsvariablen und CI-/Automatisierungsoptionen siehe Installer internals.
Wenn Sie bereits Node 22+ haben und die Installation selbst verwalten möchten:
Wenn Sie libvips global installiert haben (auf macOS häufig über Homebrew) und sharp fehlschlägt, erzwingen Sie vorgefertigte Binaries:
Wenn Sie sharp: Please add node-gyp to your dependencies sehen, installieren Sie entweder Build-Tooling (macOS: Xcode CLT + npm install -g node-gyp) oder verwenden Sie die oben genannte Umgebungsvariable.
Für Mitwirkende oder alle, die aus einem lokalen Checkout ausführen möchten.
1

Klonen und bauen

Klonen Sie das OpenClaw-Repo und bauen Sie es:
2

CLI verlinken

Machen Sie den Befehl openclaw global verfügbar:
Alternativ überspringen Sie das Verlinken und führen Befehle über pnpm openclaw ... innerhalb des Repos aus.
3

Onboarding ausführen

Für vertiefte Entwicklungs-Workflows siehe Setup.

​
Weitere Installationsmethoden

Docker

Containerisierte oder headless Bereitstellungen.

Podman

Rootless-Container: Führen Sie setup-podman.sh einmal aus, dann das Startskript.

Nix

Deklarative Installation über Nix.

Ansible

Automatisierte Bereitstellung von Flotten.

Bun

Reine CLI-Nutzung über die Bun-Runtime.

​
Nach der Installation

Überprüfen Sie, ob alles funktioniert:
Wenn Sie benutzerdefinierte Laufzeitpfade benötigen, verwenden Sie:
  • OPENCLAW_HOME für homeverzeichnisbasierte interne Pfade
  • OPENCLAW_STATE_DIR für den Speicherort veränderlicher Zustände
  • OPENCLAW_CONFIG_PATH für den Speicherort der Konfigurationsdatei
Siehe Environment vars für Prioritäten und vollständige Details.

​
Fehlerbehebung: openclaw nicht gefunden

Schnelle Diagnose:
Wenn $(npm prefix -g)/bin (macOS/Linux) oder $(npm prefix -g) (Windows) nicht in Ihrem $PATH enthalten ist, kann Ihre Shell globale npm-Binaries (einschließlich openclaw) nicht finden.Behebung — fügen Sie es Ihrer Shell-Startdatei hinzu (~/.zshrc oder ~/.bashrc):
Unter Windows fügen Sie die Ausgabe von npm prefix -g zu Ihrem PATH hinzu.Öffnen Sie anschließend ein neues Terminal (oder rehash in zsh / hash -r in bash).

​
Aktualisieren / Deinstallieren

Updating

Halten Sie OpenClaw auf dem neuesten Stand.

Migrating

Wechseln Sie auf einen neuen Rechner.

Uninstall

Entfernen Sie OpenClaw vollständig.