Skip to main content

​
Systemanforderungen

  • Node 22.22.3+, 24.15+ oder 25.9+ – Node 24 ist das standardmäßige Ziel; das Installationsskript übernimmt dies automatisch.
  • macOS, Linux oder Windows – Windows-Benutzer können mit der nativen Windows-Hub-App, dem PowerShell-CLI-Installationsprogramm oder einem WSL2-Gateway beginnen. Siehe Windows.
  • pnpm wird nur benötigt, wenn Sie aus dem Quellcode erstellen.

​
Empfohlen: Installationsskript

Die schnellste Installationsmethode. Sie erkennt Ihr Betriebssystem, installiert bei Bedarf Node, installiert OpenClaw und startet das Onboarding.
Benutzer der Windows-Desktopversion können auch die native Begleit-App Windows Hub installieren, die Einrichtung, Taskleistenstatus, Chat, Node-Modus und lokalen MCP-Modus umfasst.
So installieren Sie ohne Ausführung des Onboardings:
Alle Flags und Optionen für CI/Automatisierung finden Sie unter Interna des Installationsprogramms.

​
Alternative Installationsmethoden

​
Installationsprogramm mit lokalem Präfix (install-cli.sh)

Verwenden Sie diese Methode, wenn OpenClaw und Node unter einem lokalen Präfix wie ~/.openclaw verbleiben sollen, ohne von einer systemweiten Node-Installation abhängig zu sein:
Standardmäßig werden npm-Installationen unterstützt, zusätzlich zu Installationen aus einem Git-Checkout im selben Präfixablauf. Vollständige Referenz: Interna des Installationsprogramms. Bereits installiert? Wechseln Sie mit openclaw update --channel dev und openclaw update --channel stable zwischen Paket- und Git-Installationen. Siehe Aktualisierung.

​
npm, pnpm oder bun

Wenn Sie Node bereits selbst verwalten:
Das gehostete Installationsprogramm entfernt npm-Aktualitätsfilter wie min-release-age für die Installation des OpenClaw-Pakets. Wenn Sie die Installation manuell mit npm durchführen, gilt weiterhin Ihre eigene npm-Richtlinie.

​
Aus dem Quellcode

Für Mitwirkende oder alle, die OpenClaw aus einem lokalen Checkout ausführen möchten:
Alternativ können Sie die Verknüpfung überspringen und pnpm openclaw ... innerhalb des Repositorys verwenden. Vollständige Entwicklungsabläufe finden Sie unter Einrichtung.

​
Installation aus dem GitHub-Checkout von main

​
Container und Paketmanager

Docker

Containerisierte oder monitorlose Bereitstellungen.

Podman

Rootless-Containeralternative zu Docker.

Nix

Deklarative Installation über Nix-Flake.

Ansible

Automatisierte Flottenbereitstellung.

Bun

Optionales Installationsprogramm für Abhängigkeiten und Ausführungsprogramm für Paketskripte.

​
Installation überprüfen

Wenn Sie nach der Installation einen verwalteten Start wünschen:
  • macOS: LaunchAgent über openclaw onboard --install-daemon oder openclaw gateway install
  • Linux/WSL2: systemd-Benutzerdienst über dieselben Befehle
  • Natives Windows: zunächst eine geplante Aufgabe, mit einem benutzerspezifischen Anmeldeelement im Autostartordner als Ausweichlösung, falls das Erstellen der Aufgabe verweigert wird

​
Hosting und Bereitstellung

Stellen Sie OpenClaw auf einem Cloud-Server oder VPS bereit. Unter Linux-Server finden Sie die vollständige Provider-Auswahl (DigitalOcean, Hetzner, Hostinger, Fly.io, GCP, Azure, Railway, Northflank, Oracle Cloud, Raspberry Pi und weitere), oder führen Sie die Bereitstellung deklarativ auf Render durch.

VPS

Wählen Sie einen Provider.

Docker-VM

Gemeinsame Docker-Schritte.

Kubernetes

K8s-Bereitstellung.

​
Aktualisieren, migrieren oder deinstallieren

Aktualisierung

Halten Sie OpenClaw auf dem neuesten Stand.

Migration

Wechseln Sie auf einen neuen Computer.

Deinstallation

Entfernen Sie OpenClaw vollständig.

​
Fehlerbehebung: openclaw nicht gefunden

Fast immer handelt es sich um ein PATH-Problem: Das globale Binärverzeichnis von npm befindet sich nicht im PATH Ihrer Shell. Unter Fehlerbehebung für Node.js finden Sie die vollständige Lösung einschließlich des Windows-Pfads.