Zum Hauptinhalt springen

​
Installieren

​
Empfohlen: Installationsskript

Der schnellste Weg zur Installation. Es erkennt Ihr Betriebssystem, installiert bei Bedarf Node, installiert OpenClaw und startet das Onboarding. 
curl -fsSL https://openclaw.ai/install.sh | bash
So installieren Sie, ohne das Onboarding auszuführen: 
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Für alle Flags und Optionen für CI/Automatisierung siehe Installer internals.

​
Systemanforderungen

  • Node 24 (empfohlen) oder Node 22.14+ — das Installationsskript übernimmt dies automatisch
  • macOS, Linux oder Windows — sowohl natives Windows als auch WSL2 werden unterstützt; WSL2 ist stabiler. Siehe Windows.
  • pnpm wird nur benötigt, wenn Sie aus dem Source bauen

​
Alternative Installationsmethoden

​
Installer mit lokalem Präfix (install-cli.sh)

Verwenden Sie dies, wenn OpenClaw und Node unter einem lokalen Präfix wie ~/.openclaw gehalten werden sollen, ohne von einer systemweiten Node-Installation abzuhängen: 
curl -fsSL https://openclaw.ai/install-cli.sh | bash
Standardmäßig werden npm-Installationen unterstützt sowie Installationen aus einem Git-Checkout innerhalb desselben Präfix-Ablaufs. Vollständige Referenz: Installer internals.

​
npm, pnpm oder bun

Wenn Sie Node bereits selbst verwalten: 
npm install -g openclaw@latest
openclaw onboard --install-daemon
Wenn sharp aufgrund eines global installierten libvips fehlschlägt:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

​
Aus dem Source

Für Mitwirkende oder alle, die aus einem lokalen Checkout ausführen möchten: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global
openclaw onboard --install-daemon
Oder überspringen Sie das Linken und verwenden Sie pnpm openclaw ... innerhalb des Repos. Siehe Setup für vollständige Entwicklungs-Workflows.

​
Von GitHub main installieren

npm install -g github:openclaw/openclaw#main

​
Container und Paketmanager

Docker

Containerisierte oder Headless-Bereitstellungen.

Podman

Rootless-Container-Alternative zu Docker.

Nix

Deklarative Installation über Nix Flake.

Ansible

Automatisierte Bereitstellung von Flotten.

Bun

Nur-CLI-Nutzung über die Bun-Laufzeit.

​
Installation verifizieren

openclaw --version      # bestätigen, dass die CLI verfügbar ist
openclaw doctor         # auf Konfigurationsprobleme prüfen
openclaw gateway status # verifizieren, dass das Gateway läuft
Wenn Sie nach der Installation einen verwalteten Start möchten:
  • macOS: LaunchAgent über openclaw onboard --install-daemon oder openclaw gateway install
  • Linux/WSL2: systemd-Benutzerdienst über dieselben Befehle
  • Natives Windows: zuerst Scheduled Task, mit einem Login-Eintrag im Startup-Ordner pro Benutzer als Fallback, wenn das Erstellen der Aufgabe 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

Fly.io

Fly.io

Hetzner

Hetzner

GCP

Google Cloud

Azure

Azure

Railway

Railway

Render

Render

Northflank

Northflank

​
Aktualisieren, migrieren oder deinstallieren

Aktualisieren

OpenClaw aktuell halten.

Migrieren

Auf einen neuen Rechner umziehen.

Deinstallieren

OpenClaw vollständig entfernen.

​
Fehlerbehebung: openclaw nicht gefunden

Wenn die Installation erfolgreich war, aber openclaw in Ihrem Terminal nicht gefunden wird: 
node -v           # Ist Node installiert?
npm prefix -g     # Wo befinden sich globale Pakete?
echo "$PATH"      # Ist das globale bin-Verzeichnis in PATH?
Wenn $(npm prefix -g)/bin nicht in Ihrem $PATH ist, fügen Sie es Ihrer Shell-Startdatei hinzu (~/.zshrc oder ~/.bashrc): 
export PATH="$(npm prefix -g)/bin:$PATH"
Öffnen Sie danach ein neues Terminal. Siehe Node setup für weitere Details.