Zum Hauptinhalt springen

​
Systemanforderungen

  • Node 24 (empfohlen) oder Node 22.19+ - das Installer-Skript übernimmt dies automatisch
  • macOS, Linux oder Windows - Windows-Nutzer können mit der nativen Windows Hub-App, dem PowerShell-CLI-Installer oder einem WSL2-Gateway starten. Siehe Windows.
  • pnpm wird nur benötigt, wenn Sie aus dem Quellcode bauen

​
Empfohlen: Installer-Skript

Der schnellste Weg zur Installation. Es erkennt Ihr Betriebssystem, installiert bei Bedarf Node, installiert OpenClaw und startet das Onboarding.
Windows-Desktop-Nutzer können außerdem die native Begleit-App Windows Hub installieren, die Einrichtung, Tray-Status, Chat, Node-Modus und lokalen MCP-Modus enthält.
curl -fsSL https://openclaw.ai/install.sh | bash
Installation ohne Ausführen des Onboardings: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Alle Flags und CI-/Automatisierungsoptionen 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 abgelegt 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, außerdem Git-Checkout-Installationen im selben Präfixablauf. 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 install -g openclaw@latest
openclaw onboard --install-daemon
Der gehostete Installer entfernt npm-Aktualitätsfilter wie min-release-age für die Installation des OpenClaw-Pakets. Wenn Sie manuell mit npm installieren, gilt weiterhin Ihre eigene npm-Richtlinie.

​
Aus dem Quellcode

Für Beitragende oder alle, die aus einem lokalen Checkout heraus ausführen möchten: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Oder überspringen Sie den Link und verwenden Sie pnpm openclaw ... innerhalb des Repos. 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

Docker

Containerisierte oder Headless-Bereitstellungen.

Podman

Rootless-Container-Alternative zu Docker.

Nix

Deklarative Installation über Nix-Flake.

Ansible

Automatisierte Flottenbereitstellung.

Bun

Reine CLI-Nutzung über die Bun-Laufzeit.

​
Installation überprüfen

openclaw --version      # confirm the CLI is available
openclaw doctor         # check for config issues
openclaw 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: zuerst geplante Aufgabe, mit einem Login-Eintrag im benutzerspezifischen Autostart-Ordner als Fallback, falls die Aufgabenerstellung verweigert wird

​
Hosting und Bereitstellung

Stellen Sie OpenClaw auf einem Cloud-Server oder VPS bereit:

VPS

Beliebiger Linux-VPS.

Docker VM

Gemeinsame Docker-Schritte.

Kubernetes

K8s-Bereitstellung.

Fly.io

Auf Fly.io bereitstellen.

Hetzner

Hetzner-Bereitstellung.

GCP

Google Cloud-Bereitstellung.

Azure

Azure-Bereitstellung.

Railway

Railway-Bereitstellung.

Render

Render-Bereitstellung.

Northflank

Northflank-Bereitstellung.

​
Aktualisieren, migrieren oder deinstallieren

Updating

Halten Sie OpenClaw aktuell.

Migrating

Auf einen neuen Computer umziehen.

Uninstall

OpenClaw vollständig entfernen.

​
Fehlerbehebung: openclaw nicht gefunden

Wenn die Installation erfolgreich war, openclaw in Ihrem Terminal aber 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 ist, fügen Sie es Ihrer Shell-Startdatei (~/.zshrc oder ~/.bashrc) hinzu: 
export PATH="$(npm prefix -g)/bin:$PATH"
Öffnen Sie anschließend ein neues Terminal. Weitere Details finden Sie unter Node-Einrichtung.