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.
  • pnpm wird 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

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 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:

VPS
Docker VM
Kubernetes

OPENCLAW_DOCS_MARKER:cardOpen:IHRpdGxlPSJGbHkuaW8iIGhyZWY9Ii9kZS9pbnN0YWxsL2ZseSI Fly.io OPENCLAW_DOCS_MARKER:cardClose:

Hetzner
GCP
Azure
Railway
Render
Northflank

Aktualisieren, migrieren oder deinstallieren

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.