Installieren

Systemanforderungen

• Node 22.19+, 23.11+ oder 24+ – Node 24 ist das Standardziel; 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 kompilieren.

Empfohlen: Installationsskript

Die schnellste Installationsmethode. Das Skript erkennt Ihr Betriebssystem, installiert bei Bedarf Node, installiert OpenClaw und startet die Ersteinrichtung.

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

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

So installieren Sie OpenClaw, ohne die Ersteinrichtung auszuführen:

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 und 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 sowie Installationen aus einem Git-Checkout mit demselben Präfixablauf unterstützt. 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.

Aus dem GitHub-Checkout des main-Branches installieren

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      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw gateway status # verify the Gateway is running

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; falls die Aufgabenerstellung verweigert wird, wird ersatzweise pro Benutzer ein Anmeldeelement im Autostartordner verwendet

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). Alternativ können Sie OpenClaw deklarativ auf Render bereitstellen.

Aktualisieren, migrieren oder deinstallieren

Fehlerbehebung: openclaw nicht gefunden

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

node -v           # Node installed?npm prefix -g     # Where are global packages?echo "$PATH"      # Is the global bin dir in PATH?