OpenClaw installieren – So funktionieren die Installer

Kennst du das? Du willst ein neues Tool ausprobieren, aber die Installation scheitert an fehlenden Abhängigkeiten oder falschen Berechtigungen. Oft verbringst du mehr Zeit damit, deine Umgebung zu reparieren, als die Software tatsächlich zu nutzen.

Damit du direkt loslegen kannst, bietet OpenClaw verschiedene Installer-Scripts an, die sich um die Details kümmern.

Voraussetzungen

Bevor du startest, stelle sicher, dass du eines dieser Betriebssysteme nutzt:

macOS
Linux
WSL
Windows (PowerShell)

Schnellstart

In weniger als fünf Minuten ist OpenClaw auf deinem System. Wähle einfach das passende Script für deine Plattform aus.

install.sh (macOS / Linux / WSL)

Dieses Script installiert Node.js, falls es fehlt. OpenClaw wird standardmäßig über npm oder git installiert. Danach kann direkt das onboarding starten.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

Für Hilfe zu den Parametern:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help

install-cli.sh (macOS / Linux / WSL)

Wenn du keine Root-Rechte hast, ist das dein Script. Es installiert Node.js und OpenClaw lokal in den Pfad ~/.openclaw.

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

Hilfe-Befehl:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --help

install.ps1 (Windows)

Für Windows-Nutzer erledigt dieses PowerShell-Script die Arbeit. Es installiert Node.js bei Bedarf und OpenClaw via npm oder git.

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

Beispiel für eine Installation der Beta-Version ohne onboarding und als Trockenlauf:

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

Fehlerbehebung

Falls die Installation erfolgreich war, aber der Befehl openclaw in einem neuen Terminal nicht gefunden wird, liegt das meist an der Node.js-Konfiguration. Schau dir in diesem Fall das Node.js troubleshooting an.

Hast du Fragen zur Einrichtung? Unser AI Setup Assistant hilft dir direkt weiter.

Nächste Schritte

---
title: OpenClaw mit install.sh installieren
description: Der schnellste Weg, OpenClaw auf macOS, Linux oder WSL einzurichten.
---

Kennst du das? Du willst ein neues Tool ausprobieren, aber verbringst die erste halbe Stunde damit, Node-Versionen zu prüfen, fehlende Dependencies zu installieren oder Umgebungsvariablen zu fixen. Das hält den Workflow auf und nervt einfach nur.

Ich empfehle dir für die meisten interaktiven Setups auf macOS, Linux oder WSL das `install.sh` Skript. Es nimmt dir die manuelle Arbeit ab und sorgt dafür, dass deine Umgebung sofort startklar ist.

## Voraussetzungen

Bevor du startest, stelle sicher, dass dein System die folgenden Anforderungen erfüllt (das Skript versucht zwar, vieles automatisch zu lösen, aber das sind die Grundlagen):

- macOS oder Linux (inklusive WSL)
- Internetverbindung für den Download von Node.js und Git

## Schnellstart

In weniger als 5 Minuten ist OpenClaw einsatzbereit. Kopiere einfach diesen Befehl in dein Terminal:

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

Dieser Standard-Befehl erkennt dein Betriebssystem, prüft auf Node.js 22+ sowie Git und führt die Installation per npm durch.

Der Installations-Flow

Das Skript arbeitet eine klare Logik ab, damit am Ende alles läuft:

OS Detection: Erkennt macOS oder Linux. Auf dem Mac wird Homebrew installiert, falls es fehlt.
Node.js 22+ Check: Falls deine Version zu alt ist, wird Node 22 installiert (über Homebrew auf macOS oder NodeSource Scripts auf Linux).
Git Check: Installiert Git, falls es noch nicht auf deinem System vorhanden ist.
OpenClaw Installation:
- npm Methode (Standard): Globale Installation via npm.
- git Methode: Klonen des Repo, Installation der Dependencies mit pnpm, Build-Prozess und Wrapper-Setup unter ~/.local/bin/openclaw.
Post-install: Führt bei Upgrades openclaw doctor --non-interactive aus und startet das Onboarding, sofern ein TTY verfügbar ist. Standardmäßig wird SHARP_IGNORE_GLOBAL_LIBVIPS=1 gesetzt.

Erkennung von Source Checkouts

Wenn du das Skript innerhalb eines OpenClaw Checkouts ausführst (erkannt an package.json und pnpm-workspace.yaml), hast du die Wahl:

Das lokale Checkout nutzen (git)
Eine globale Installation durchführen (npm)

Falls kein TTY verfügbar ist und keine Methode explizit gewählt wurde, nutzt das Skript automatisch npm und gibt eine Warnung aus.

Beispiele

Hier sind ein paar Varianten, wie du das Skript mit Flags anpassen kannst:

Standard:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

Onboarding überspringen:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-onboard

Git Installation:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --install-method git

Dry run:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --dry-run

Fehlerbehebung

Falls etwas schiefgeht, achte auf die Fehlermeldungen:

Exit Code 2: Das Skript bricht mit diesem Code ab, wenn eine ungültige Installationsmethode gewählt wurde oder der Wert für --install-method nicht korrekt ist.
Fehlendes TTY: Wenn du das Skript in einer Umgebung ohne interaktives Terminal ausführst, stelle sicher, dass du die Flags (wie --no-onboard) korrekt setzt, da automatische Abfragen sonst fehlschlagen.

Referenz

CLI Flags

Flag	Beschreibung
`--install-method npm\|git`	Wählt die Methode (Default: `npm`). Alias: `--method`
`--npm`	Shortcut für npm Methode
`--git`	Shortcut für git Methode. Alias: `--github`
`--version <version\|dist-tag>`	npm Version oder dist-tag (Default: `latest`)
`--beta`	Nutzt den Beta-Tag, falls vorhanden
`--git-dir <path>`	Verzeichnis für Checkout (Default: `~/openclaw`)
`--no-git-update`	Überspringt `git pull` bei vorhandenem Checkout
`--no-prompt`	Deaktiviert interaktive Abfragen
`--no-onboard`	Überspringt das Onboarding
`--onboard`	Aktiviert das Onboarding explizit
`--dry-run`	Zeigt Aktionen an, ohne sie auszuführen
`--verbose`	Debug-Output aktivieren (`set -x`)
`--help`	Hilfe anzeigen (`-h`)

Umgebungsvariablen

Variable	Beschreibung
`OPENCLAW_INSTALL_METHOD=git\|npm`	Installationsmethode
`OPENCLAW_VERSION=latest\|next\|<semver>`	npm Version
`OPENCLAW_BETA=0\|1`	Beta nutzen
`OPENCLAW_GIT_DIR=<path>`	Checkout-Pfad
`OPENCLAW_GIT_UPDATE=0\|1`	Git-Updates umschalten
`OPENCLAW_NO_PROMPT=1`	Prompts deaktivieren
`OPENCLAW_NO_ONBOARD=1`	Onboarding überspringen
`OPENCLAW_DRY_RUN=1`	Dry-Run Modus
`OPENCLAW_VERBOSE=1`	Debug-Modus
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	npm Log-Level
`SHARP_IGNORE_GLOBAL_LIBVIPS=0\|1`	sharp/libvips Verhalten (Default: `1`)

Hast du Fragen zum Setup oder hängst an einem spezifischen Schritt fest? Der AI Setup Assistant hilft dir direkt weiter.

Nächste Schritte

Kennst du das? Du willst ein neues Tool ausprobieren, aber hast keine Lust, deine globale Node.js-Umgebung zu verändern oder dich mit inkompatiblen Versionen herumzuschlagen. Oft enden solche Versuche in einem Chaos aus Berechtigungsproblemen und Versionskonflikten, die deinen gesamten Workflow aufhalten.

Wenn du eine saubere Trennung bevorzugst und möchtest, dass ein Tool einfach in seinem eigenen Verzeichnis läuft, ist das `install-cli.sh` Script die beste Wahl für dich. Es hält alles unter einem lokalen Pfad und lässt dein restliches System komplett unberührt.

## Voraussetzungen

Bevor du startest, stelle sicher, dass deine Umgebung passt. Das Script ist für folgende Setups optimiert:

- Linux (mit `apt`, `dnf` oder `yum` für Git-Abhängigkeiten)
- macOS (mit Homebrew für Git-Abhängigkeiten)
- Eine aktive Internetverbindung für den Download der Binaries

## Schnellstart

In weniger als 5 Minuten ist OpenClaw einsatzbereit. Das Script automatisiert den gesamten Prozess für dich:

1.  **Lokale Node Runtime:** Lädt ein Node tarball (Standard `22.22.0`) nach `<prefix>/tools/node-v<version>` herunter und prüft die SHA-256 Checksumme.
2.  **Git Check:** Falls Git fehlt, wird versucht, es über den Paketmanager deines Systems zu installieren.
3.  **OpenClaw Installation:** Installiert OpenClaw via npm mit dem `--prefix` Flag und erstellt einen Wrapper unter `<prefix>/bin/openclaw`.

Hier ist der Befehl für die Standard-Installation (verwendet `~/.openclaw`):

```bash
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash

Weitere Beispiele

Du kannst die Installation über Parameter an deine Bedürfnisse anpassen:

Eigener Pfad und Version:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --prefix /opt/openclaw --version latest

Automatisierung mit JSON-Output:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

Direktes Onboarding nach Installation:

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --onboard

Konfiguration

Hier findest du alle verfügbaren CLI Flags und Umgebungsvariablen, um die Installation zu steuern.

Flags Reference

Flag	Beschreibung
`--prefix <path>`	Installationspfad (Default: `~/.openclaw`)
`--version <ver>`	OpenClaw Version oder dist-tag (Default: `latest`)
`--node-version <ver>`	Node Version (Default: `22.22.0`)
`--json`	Gibt NDJSON Events aus
`--onboard`	Führt `openclaw onboard` nach der Installation aus
`--no-onboard`	Überspringt das Onboarding (Default)
`--set-npm-prefix`	Erzwingt unter Linux `~/.npm-global`, falls der aktuelle Pfad nicht beschreibbar ist
`--help`	Zeigt die Hilfe an (`-h`)

Environment Variables Reference

Variable	Beschreibung
`OPENCLAW_PREFIX=<path>`	Installationspfad
`OPENCLAW_VERSION=<ver>`	OpenClaw Version oder dist-tag
`OPENCLAW_NODE_VERSION=<ver>`	Node Version
`OPENCLAW_NO_ONBOARD=1`	Überspringt das Onboarding
`OPENCLAW_NPM_LOGLEVEL=error\|warn\|notice`	npm Log-Level
`OPENCLAW_GIT_DIR=<path>`	Pfad für Legacy-Cleanup (suche nach alten `Peekaboo` Submodul-Checkouts)
`SHARP_IGNORE_GLOBAL_LIBVIPS=0\|1`	Steuert sharp/libvips Verhalten (Default: `1`)

Fehlerbehebung

Falls während der Installation Probleme auftreten, prüfe diese Punkte:

Git fehlt: Das Script versucht Git automatisch zu installieren. Falls das fehlschlägt, installiere Git manuell über deinen Paketmanager, bevor du das Script erneut startest.
Schreibrechte: Wenn das Zielverzeichnis nicht beschreibbar ist, nutze das --set-npm-prefix Flag (auf Linux), um npm anzuweisen, ~/.npm-global zu nutzen.
Node-Version: Falls deine Umgebung eine spezielle Node-Version erfordert, kannst du diese mit --node-version erzwingen.

Du hast Fragen zum Setup oder brauchst Hilfe bei der Konfiguration? Frag den AI Setup Assistant.

Nächste Schritte

Hook

Kennst du das? Du willst ein neues Tool ausprobieren, aber die Einrichtung der Umgebung dauert länger als das eigentliche Projekt. Pfade manuell setzen, Abhängigkeiten prüfen und Berechtigungen verwalten nerven im Entwickler-Alltag extrem. Du willst einfach nur, dass die Software läuft, ohne dich durch endlose Installationsanleitungen zu quälen.

Das install.ps1 Script für OpenClaw nimmt dir diesen Stress ab. Es automatisiert die Prüfung deiner Umgebung und installiert alles Nötige, damit du sofort starten kannst.

Voraussetzungen

Bevor du startest, stelle sicher, dass deine Umgebung diese Anforderungen erfüllt:

Windows-Betriebssystem
PowerShell 5+
Node.js 22+ (falls es fehlt, versucht das Script die Installation für dich)
Git (nur erforderlich, wenn du die Git-Installationsmethode wählst)

Schnellstart

Für die Standard-Installation über npm öffnest du deine PowerShell und führst diesen Befehl aus:

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

Das Script führt im Hintergrund folgende Schritte aus:

Es prüft, ob Node.js 22+ vorhanden ist. Falls nicht, versucht es eine Installation via winget, Chocolatey oder Scoop.
Es installiert OpenClaw global über npm.
Es fügt das notwendige bin-Verzeichnis zu deinem PATH hinzu.
Es führt openclaw doctor --non-interactive aus, um die Installation zu verifizieren.

Alternative Installationsmethoden

Wenn du lieber direkt aus dem Repository arbeitest, kannst du die Git-Methode nutzen. Dabei wird das Repo geklont, mit pnpm gebaut und ein Wrapper unter %USERPROFILE%\.local\bin\openclaw.cmd erstellt.

Git-Installation:

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

Custom Verzeichnis für Git:

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -InstallMethod git -GitDir "C:\openclaw"

Dry Run (Aktionen nur anzeigen, nichts installieren):

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

Flags Referenz

Du kannst das Verhalten des Scripts über verschiedene Flags steuern:

Flag	Beschreibung
`-InstallMethod npm\|git`	Installationsmethode (Standard: `npm`)
`-Tag <tag>`	npm dist-tag (Standard: `latest`)
`-GitDir <path>`	Checkout-Verzeichnis (Standard: `%USERPROFILE%\openclaw`)
`-NoOnboard`	Onboarding überspringen
`-NoGitUpdate`	`git pull` überspringen
`-DryRun`	Nur geplante Aktionen ausgeben

Umgebungsvariablen

Alternativ zu den Flags kannst du Umgebungsvariablen nutzen:

Variable	Beschreibung
`OPENCLAW_INSTALL_METHOD=git\|npm`	Installationsmethode
`OPENCLAW_GIT_DIR=<path>`	Checkout-Verzeichnis
`OPENCLAW_NO_ONBOARD=1`	Onboarding deaktivieren
`OPENCLAW_DRY_RUN=1`	Dry Run Modus

Fehlerbehebung

Hier sind Lösungen für Fehler, die während des Prozesses auftreten können:

Git fehlt: Wenn du -InstallMethod git nutzt, aber kein Git installiert ist, bricht das Script ab. Es gibt dir in diesem Fall direkt den Link zu “Git for Windows” aus, damit du es nachinstallieren kannst.
Node.js Probleme: Sollte Node.js 22+ nicht gefunden werden, versucht das Script nacheinander winget, Chocolatey und Scoop. Stelle sicher, dass einer dieser Package Manager installiert ist, falls du Node.js nicht manuell installieren möchtest.
PATH-Aktualisierung: Das Script versucht, das bin-Verzeichnis automatisch zum PATH hinzuzufügen. In manchen Fällen musst du die PowerShell neu starten, damit die Änderungen wirksam werden.

Bei weiteren Fragen hilft dir der AI Setup Assistant gerne weiter.

Nächste Schritte

Du kennst das: Dein CI-Job bricht plötzlich ab, weil ein Installationsskript mitten im Lauf auf eine manuelle Bestätigung wartet. In einer automatisierten Umgebung gibt es niemanden, der “Y” drückt, und genau das führt zu hängenden Pipelines und frustrierten Entwicklern.

Damit deine Builds stabil und vorhersehbar durchlaufen, musst du Interaktionen vermeiden. Die Verwendung von non-interactive Flags sorgt dafür, dass deine Skripte ohne menschliches Zutun genau das tun, was sie sollen.

What You’ll Need

Git (erforderlich für die Git-Installationsmethode oder für Abhängigkeiten mit Git-URLs)
Node.js und npm (für Installationen via npm)

Quick Start

Nutze non-interactive Flags oder Umgebungsvariablen für vorhersehbare Abläufe in deiner CI. Hier sind die schnellsten Wege für verschiedene Umgebungen:

install.sh (non-interactive npm):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

install.sh (non-interactive git):

OPENCLAW_INSTALL_METHOD=git OPENCLAW_NO_PROMPT=1 \
  curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

install-cli.sh (JSON):

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash -s -- --json --prefix /opt/openclaw

install.ps1 (skip onboarding):

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

Troubleshooting

Warum ist Git erforderlich?

Git wird zwingend für die git Installationsmethode benötigt. Bei npm Installationen wird Git ebenfalls geprüft oder installiert. Das verhindert spawn git ENOENT Fehler, falls Abhängigkeiten Git-URLs verwenden.

Warum meldet npm EACCES auf Linux?

Manche Linux-Setups lassen den globalen npm-Prefix auf Pfade zeigen, die Root gehören. install.sh kann den Prefix auf ~/.npm-global ändern und PATH-Exports in deine Shell-RC-Dateien schreiben, sofern diese existieren.

sharp/libvips Probleme

Die Skripte nutzen standardmäßig SHARP_IGNORE_GLOBAL_LIBVIPS=1. Damit wird verhindert, dass sharp gegen das systemeigene libvips baut. Falls du das überschreiben willst:

SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

Windows: “npm error spawn git / ENOENT”

Installiere Git for Windows, öffne die PowerShell neu und starte den Installer erneut.

Windows: “openclaw is not recognized”

Führe npm config get prefix aus, hänge \bin an den Pfad an und füge dieses Verzeichnis deinem User-PATH hinzu. Starte danach die PowerShell neu.

openclaw wurde nach der Installation nicht gefunden

Das liegt meistens an einem PATH-Problem. Schau dir dazu das Node.js troubleshooting an.

Falls du bei der Einrichtung in deiner speziellen Umgebung Hilfe brauchst, frag den AI Setup Assistant.

What’s Next

OpenClaw Expert

Noch festgefahren?

Wenn diese Seite nicht hilft, frage OpenClaw Expert nach Schritt-fuer-Schritt-Loesungen.