Install overview
Installieren
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.
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 | bash
Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex
Zur Installation ohne Ausführen des Onboardings:
macOS / Linux / WSL2
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Windows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Alle Flags und CI-/Automatisierungsoptionen finden Sie unter Installer-Interna.
Alternative Installationsmethoden
Lokaler Präfix-Installer (install-cli.sh)
Verwenden Sie dies, wenn OpenClaw und Node unter einem lokalen Präfix wie
~/.openclaw liegen 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ä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
Aktualisierung.
npm, pnpm oder bun
Wenn Sie Node bereits selbst verwalten:
npm
npm install -g openclaw@latest
openclaw onboard --install-daemon
pnpm
pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon
bun
bun add -g openclaw@latest
openclaw onboard --install-daemon
Fehlerbehebung: sharp-Build-Fehler (npm)
Wenn sharp aufgrund einer global installierten libvips fehlschlägt:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
Aus dem Quellcode
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 build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Oder überspringen Sie das Verknüpfen und verwenden Sie pnpm openclaw ... innerhalb des Repos. Siehe Einrichtung für vollständige Entwicklungsabläufe.
Aus GitHub main installieren
npm install -g github:openclaw/openclaw#main
Container und Paketmanager
Containerisierte oder headless Bereitstellungen.
Rootless-Container-Alternative zu Docker.
Deklarative Installation über Nix-Flake.
Automatisierte Flottenbereitstellung.
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-daemonoderopenclaw gateway install - Linux/WSL2: systemd-Benutzerdienst über dieselben Befehle
- Natives Windows: zuerst geplante Aufgabe, mit einem benutzerbezogenen Login-Element im Startup-Ordner als Fallback, falls die Aufgabenerstellung verweigert wird
Hosting und Bereitstellung
Stellen Sie OpenClaw auf einem Cloud-Server oder VPS bereit:
OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii9kZS9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:
Aktualisieren, migrieren oder deinstallieren
Halten Sie OpenClaw aktuell.
Wechseln Sie auf einen neuen Computer.
Entfernen Sie OpenClaw vollständig.
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 enthalten ist, fügen Sie es Ihrer Shell-Startdatei hinzu (~/.zshrc oder ~/.bashrc):
export PATH="$(npm prefix -g)/bin:$PATH"
Öffnen Sie anschließend ein neues Terminal. Weitere Details finden Sie unter Node-Einrichtung.
Docs agent