Installieren

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.

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

iwr -useb https://openclaw.ai/install.ps1 | iex

So installieren Sie ohne Ausführung des Onboardings:

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

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

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:

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

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:

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

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

Aus dem Quellcode

Für Mitwirkende oder alle, die OpenClaw aus einem lokalen Checkout ausführen möchten:

git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw onboard --install-daemon

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

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git --version main

Container und Paketmanager

Installation überprüfen

openclaw --version      # bestätigen, dass die CLI verfügbar istopenclaw doctor         # auf Konfigurationsprobleme prüfenopenclaw gateway status # überprüfen, ob das Gateway ausgeführt wird

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.

Aktualisieren, migrieren oder deinstallieren

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.

node -v           # Node installiert?npm prefix -g     # Wo befinden sich globale Pakete?echo "$PATH"      # Befindet sich das globale Binärverzeichnis in PATH?