Install overview
Installieren
Systemanforderungen
- Node 24 (empfohlen) oder Node 22.16+ - das Installationsskript erledigt dies automatisch
- macOS, Linux oder Windows - sowohl natives Windows als auch WSL2 werden unterstützt; WSL2 ist stabiler. Siehe Windows.
pnpmwird nur benötigt, wenn Sie aus dem Quellcode bauen
Empfohlen: Installationsskript
Der schnellste Weg zur Installation. Es erkennt Ihr Betriebssystem, installiert Node bei Bedarf, installiert OpenClaw und startet das Onboarding.
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bashWindows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iexInstallation ohne Onboarding:
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboardWindows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboardAlle Flags und Optionen für CI/Automatisierung finden Sie unter Installer-Interna.
Alternative Installationsmethoden
Installer mit lokalem Präfix (install-cli.sh)
Verwenden Sie dies, wenn OpenClaw und Node unter einem lokalen Präfix wie
~/.openclaw bleiben sollen, ohne von einer systemweiten Node-Installation abhängig zu sein:
curl -fsSL https://openclaw.ai/install-cli.sh | bashEr unterstützt standardmäßig npm-Installationen sowie Git-Checkout-Installationen im gleichen Präfix-Ablauf. Vollständige Referenz: Installer-Interna.
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
npm install -g openclaw@latestopenclaw onboard --install-daemonpnpm
pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemonbun
bun add -g openclaw@latestopenclaw onboard --install-daemonFehlerbehebung: sharp-Buildfehler (npm)
Wenn sharp aufgrund eines global installierten libvips fehlschlägt:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latestAus dem Quellcode
Für Mitwirkende oder alle, die 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-daemonOder überspringen Sie den Link und verwenden Sie pnpm openclaw ... innerhalb des Repos. Vollständige Entwicklungsabläufe finden Sie unter Einrichtung.
Von GitHub main installieren
npm install -g github:openclaw/openclaw#mainContainer und Paketmanager
Containerisierte oder headless Deployments.
Rootless-Container-Alternative zu Docker.
Deklarative Installation per Nix-Flake.
Automatisierte Flottenbereitstellung.
Reine CLI-Nutzung über die Bun-Laufzeit.
Installation überprüfen
openclaw --version # confirm the CLI is availableopenclaw doctor # check for config issuesopenclaw gateway status # verify the Gateway is runningWenn Sie nach der Installation einen verwalteten Start wünschen:
- macOS: LaunchAgent über
openclaw onboard --install-daemonoderopenclaw gateway install - Linux/WSL2: systemd-Benutzerdienst über dieselben Befehle
- Natives Windows: zuerst Geplante Aufgabe, mit einem Login-Element im Startup-Ordner pro Benutzer als Fallback, falls die Aufgabenerstellung verweigert wird
Hosting und Deployment
Stellen Sie OpenClaw auf einem Cloud-Server oder VPS bereit:
Aktualisieren, migrieren oder deinstallieren
Halten Sie OpenClaw aktuell.
Auf einen neuen Rechner umziehen.
OpenClaw vollständig entfernen.
Fehlerbehebung: openclaw nicht gefunden
Wenn die Installation erfolgreich war, openclaw aber in Ihrem Terminal nicht gefunden wird:
node -v # Node installed?npm prefix -g # Where are global packages?echo "$PATH" # Is the global bin dir in PATH?Wenn $(npm prefix -g)/bin nicht in Ihrem $PATH enthalten ist, fügen Sie es Ihrer Shell-Startdatei (~/.zshrc oder ~/.bashrc) hinzu:
export PATH="$(npm prefix -g)/bin:$PATH"Öffnen Sie danach ein neues Terminal. Weitere Details finden Sie unter Node-Einrichtung.