Installieren

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.

curl -fsSL https://openclaw.ai/install.sh | bash

iwr -useb https://openclaw.ai/install.ps1 | iex

Installation ohne Ausführen des Onboardings:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

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@latestopenclaw onboard --install-daemon

pnpm add -g openclaw@latestpnpm approve-builds -gopenclaw onboard --install-daemon

bun add -g openclaw@latestopenclaw onboard --install-daemon

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.gitcd openclawpnpm install && pnpm build && pnpm ui:buildpnpm link --globalopenclaw 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

Installation überprüfen

openclaw --version      # confirm the CLI is availableopenclaw doctor         # check for config issuesopenclaw 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:

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