Installation

Du hast bereits Erste Schritte befolgt? Dann bist du startklar — diese Seite behandelt alternative Installationsmethoden, plattformspezifische Anleitungen und Wartung.

Systemanforderungen

Node 24 (empfohlen) (Node 22 LTS, aktuell 22.16+, wird weiterhin für Kompatibilität unterstützt; das Installationsskript installiert Node 24, falls nicht vorhanden)
macOS, Linux oder Windows
pnpm nur wenn du aus dem Quellcode baust

Hinweis: Unter Windows empfehlen wir dringend, OpenClaw unter WSL2 auszuführen.

Installationsmethoden

Tipp: Das Installationsskript ist der empfohlene Weg, OpenClaw zu installieren. Es kümmert sich um Node-Erkennung, Installation und Onboarding in einem Schritt.

Warnung: Für VPS/Cloud-Hosts solltest du möglichst keine “1-Click”-Marketplace-Images von Drittanbietern verwenden. Nimm lieber ein sauberes Basis-OS-Image (z.B. Ubuntu LTS) und installiere OpenClaw selbst mit dem Installationsskript.

Installationsskript

Lädt das CLI herunter, installiert es global per npm und startet den Einrichtungsassistenten.


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash
    ```

  #### Windows (PowerShell)
    ```powershell
    iwr -useb https://openclaw.ai/install.ps1 | iex
    ```



Das war's — das Skript übernimmt Node-Erkennung, Installation und Onboarding.

Um das Onboarding zu überspringen und nur das Binary zu installieren:


  #### macOS / Linux / WSL2
    ```bash
    curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
    ```

  #### Windows (PowerShell)
    ```powershell
    & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
    ```



Alle Flags, Umgebungsvariablen und CI/Automatisierungsoptionen findest du unter [Installer-Details](/docs/install/installer).

npm / pnpm

Wenn du Node selbst verwaltest, empfehlen wir Node 24. OpenClaw unterstützt weiterhin Node 22 LTS, aktuell `22.16+`, für Kompatibilität:


  #### npm
    ```bash
    npm install -g openclaw@latest
    openclaw onboard --install-daemon
    ```

    <details>

Build-Fehler bei sharp?

      Falls libvips global installiert ist (häufig auf macOS über Homebrew) und `sharp` fehlschlägt, erzwinge vorgefertigte Binaries:

      ```bash
      SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
      ```

      Bei `sharp: Please add node-gyp to your dependencies` installiere die Build-Tools (macOS: Xcode CLT + `npm install -g node-gyp`) oder verwende die obige Umgebungsvariable.
    </details>

  #### pnpm
    ```bash
    pnpm add -g openclaw@latest
    pnpm approve-builds -g        # openclaw, node-llama-cpp, sharp usw. genehmigen
    openclaw onboard --install-daemon
    ```

    > **Hinweis:** pnpm erfordert eine explizite Genehmigung für Pakete mit Build-Skripten. Nach der ersten Installation, wenn die Warnung "Ignored build scripts" erscheint, führe `pnpm approve-builds -g` aus und wähle die aufgelisteten Pakete.

Aus dem Quellcode

Für Contributors oder alle, die aus einem lokalen Checkout arbeiten möchten.


  ### Schritt 1: Klonen und bauen
    Klone das [OpenClaw-Repository](https://github.com/openclaw/openclaw) und baue:

    ```bash
    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    pnpm install
    pnpm ui:build
    pnpm build
    ```

  ### Schritt 2: CLI verlinken
    Mache den `openclaw`-Befehl global verfügbar:

    ```bash
    pnpm link --global
    ```

    Alternativ kannst du den Link überspringen und Befehle mit `pnpm openclaw ...` innerhalb des Repos ausführen.

  ### Schritt 3: Onboarding ausführen
    ```bash
    openclaw onboard --install-daemon
    ```



Für weitergehende Entwicklungs-Workflows siehe [Setup](/docs/start/setup).

Weitere Installationsmethoden

Docker — Containerisierte oder Headless-Deployments.
Podman — Rootless-Container: führe setup-podman.sh einmal aus, dann das Startskript.
Nix — Deklarative Installation über Nix.
Ansible — Automatisierte Flottenbereitstellung.
Bun — Nur-CLI-Nutzung über die Bun-Runtime.

Nach der Installation

Prüfe, ob alles funktioniert:

openclaw doctor         # auf Konfigurationsprobleme prüfen
openclaw status         # Gateway-Status
openclaw dashboard      # Browser-UI öffnen

Wenn du benutzerdefinierte Runtime-Pfade brauchst:

OPENCLAW_HOME für Home-Verzeichnis-basierte interne Pfade
OPENCLAW_STATE_DIR für den Speicherort des veränderlichen Status
OPENCLAW_CONFIG_PATH für den Speicherort der Konfigurationsdatei

Prioritätsregeln und alle Details findest du unter Umgebungsvariablen.

Fehlerbehebung: `openclaw` nicht gefunden

PATH-Diagnose und Korrektur

Schnelldiagnose:

node -v
npm -v
npm prefix -g
echo "$PATH"

Wenn $(npm prefix -g)/bin (macOS/Linux) oder $(npm prefix -g) (Windows) nicht in deinem $PATH ist, kann dein Shell globale npm-Binaries (einschließlich openclaw) nicht finden.

Korrektur — füge es zu deiner Shell-Startdatei (~/.zshrc oder ~/.bashrc) hinzu:

export PATH="$(npm prefix -g)/bin:$PATH"

Unter Windows füge die Ausgabe von npm prefix -g zu deinem PATH hinzu.

Öffne dann ein neues Terminal (oder führe rehash in zsh / hash -r in bash aus).

Aktualisieren / Deinstallieren

Aktualisierung — Halte OpenClaw aktuell.
Migration — Auf eine neue Maschine umziehen.
Deinstallieren — OpenClaw vollständig entfernen.