Installieren

Systemanforderungen

• Node 22.22.3+, 24.15+ oder 25.9+ – Node 24 ist das standardmäßige Ziel; das Installationsskript erledigt 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 bauen.

Empfohlen: Installationsskript

Der schnellste Installationsweg. Es 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 gespeichert werden 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 auch Installationen aus einem Git-Checkout mit demselben Präfix-Ablauf. 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 Aktualisieren.

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 den Link überspringen und pnpm openclaw ... innerhalb des Repositorys verwenden. Vollständige Entwicklungsabläufe finden Sie unter Einrichtung.

Installation aus dem GitHub-Main-Checkout

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: zuerst eine geplante Aufgabe, mit einem benutzerspezifischen Anmeldeelement im Autostartordner als Ausweichlösung, falls die Aufgabenerstellung 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 stellen Sie es deklarativ auf Render bereit.

Aktualisieren, migrieren oder deinstallieren

Fehlerbehebung: openclaw nicht gefunden

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

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