> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

# Installation

Bereits [Erste Schritte](/start/getting-started) befolgt? Dann sind Sie startklar — diese Seite ist für alternative Installationsmethoden, plattformspezifische Anleitungen und Wartung.

## Systemanforderungen

* **[Node 22+](/install/node)** (das [Installationsskript](#install-methods) installiert es, falls es fehlt)
* macOS, Linux oder Windows
* `pnpm` nur, wenn Sie aus dem Quellcode bauen

<Note>
  Unter Windows empfehlen wir dringend, OpenClaw unter [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install) auszuführen.
</Note>

## Installationsmethoden

<Tip>
  Das **Installationsskript** ist der empfohlene Weg zur Installation von OpenClaw. Es übernimmt Node-Erkennung, Installation und Onboarding in einem Schritt.
</Tip>

<AccordionGroup>
  <Accordion title="Installer script" icon="rocket" defaultOpen>
    Lädt die CLI herunter, installiert sie global über npm und startet den Onboarding-Assistenten.

    <Tabs>
      <Tab title="macOS / Linux / WSL2">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        curl -fsSL https://openclaw.ai/install.sh | bash
        ```
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
        iwr -useb https://openclaw.ai/install.ps1 | iex
        ```
      </Tab>
    </Tabs>

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

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

    <Tabs>
      <Tab title="macOS / Linux / WSL2">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
        ```
      </Tab>

      <Tab title="Windows (PowerShell)">
        ```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
        & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
        ```
      </Tab>
    </Tabs>

    Für alle Flags, Umgebungsvariablen und CI-/Automatisierungsoptionen siehe [Installer internals](/install/installer).
  </Accordion>

  <Accordion title="npm / pnpm" icon="package">
    Wenn Sie bereits Node 22+ haben und die Installation selbst verwalten möchten:

    <Tabs>
      <Tab title="npm">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        npm install -g openclaw@latest
        openclaw onboard --install-daemon
        ```

        <Accordion title="sharp-Buildfehler?">
          Wenn Sie libvips global installiert haben (auf macOS häufig über Homebrew) und `sharp` fehlschlägt, erzwingen Sie vorgefertigte Binaries:

          ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
          SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
          ```

          Wenn Sie `sharp: Please add node-gyp to your dependencies` sehen, installieren Sie entweder Build-Tooling (macOS: Xcode CLT + `npm install -g node-gyp`) oder verwenden Sie die oben genannte Umgebungsvariable.
        </Accordion>
      </Tab>

      <Tab title="pnpm">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        pnpm add -g openclaw@latest
        pnpm approve-builds -g        # approve openclaw, node-llama-cpp, sharp, etc.
        openclaw onboard --install-daemon
        ```

        <Note>
          pnpm erfordert eine explizite Genehmigung für Pakete mit Build-Skripten. Nachdem die erste Installation die Warnung „Ignored build scripts“ anzeigt, führen Sie `pnpm approve-builds -g` aus und wählen Sie die aufgeführten Pakete aus.
        </Note>
      </Tab>
    </Tabs>
  </Accordion>

  <Accordion title="From source" icon="github">
    Für Mitwirkende oder alle, die aus einem lokalen Checkout ausführen möchten.

    <Steps>
      <Step title="Klonen und bauen">
        Klonen Sie das [OpenClaw-Repo](https://github.com/openclaw/openclaw) und bauen Sie es:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        git clone https://github.com/openclaw/openclaw.git
        cd openclaw
        pnpm install
        pnpm ui:build
        pnpm build
        ```
      </Step>

      <Step title="CLI verlinken">
        Machen Sie den Befehl `openclaw` global verfügbar:

        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        pnpm link --global
        ```

        Alternativ überspringen Sie das Verlinken und führen Befehle über `pnpm openclaw ...` innerhalb des Repos aus.
      </Step>

      <Step title="Onboarding ausführen">
        ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
        openclaw onboard --install-daemon
        ```
      </Step>
    </Steps>

    Für vertiefte Entwicklungs-Workflows siehe [Setup](/start/setup).
  </Accordion>
</AccordionGroup>

## Weitere Installationsmethoden

<CardGroup cols={2}>
  <Card title="Docker" href="/install/docker" icon="container">
    Containerisierte oder headless Bereitstellungen.
  </Card>

  <Card title="Podman" href="/install/podman" icon="container">
    Rootless-Container: Führen Sie `setup-podman.sh` einmal aus, dann das Startskript.
  </Card>

  <Card title="Nix" href="/install/nix" icon="snowflake">
    Deklarative Installation über Nix.
  </Card>

  <Card title="Ansible" href="/install/ansible" icon="server">
    Automatisierte Bereitstellung von Flotten.
  </Card>

  <Card title="Bun" href="/install/bun" icon="zap">
    Reine CLI-Nutzung über die Bun-Runtime.
  </Card>
</CardGroup>

## Nach der Installation

Überprüfen Sie, ob alles funktioniert:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI
```

Wenn Sie benutzerdefinierte Laufzeitpfade benötigen, verwenden Sie:

* `OPENCLAW_HOME` für homeverzeichnisbasierte interne Pfade
* `OPENCLAW_STATE_DIR` für den Speicherort veränderlicher Zustände
* `OPENCLAW_CONFIG_PATH` für den Speicherort der Konfigurationsdatei

Siehe [Environment vars](/help/environment) für Prioritäten und vollständige Details.

## Fehlerbehebung: `openclaw` nicht gefunden

<Accordion title="PATH diagnosis and fix">
  Schnelle Diagnose:

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  node -v
  npm -v
  npm prefix -g
  echo "$PATH"
  ```

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

  Behebung — fügen Sie es Ihrer Shell-Startdatei hinzu (`~/.zshrc` oder `~/.bashrc`):

  ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
  export PATH="$(npm prefix -g)/bin:$PATH"
  ```

  Unter Windows fügen Sie die Ausgabe von `npm prefix -g` zu Ihrem PATH hinzu.

  Öffnen Sie anschließend ein neues Terminal (oder `rehash` in zsh / `hash -r` in bash).
</Accordion>

## Aktualisieren / Deinstallieren

<CardGroup cols={3}>
  <Card title="Updating" href="/install/updating" icon="refresh-cw">
    Halten Sie OpenClaw auf dem neuesten Stand.
  </Card>

  <Card title="Migrating" href="/install/migrating" icon="arrow-right">
    Wechseln Sie auf einen neuen Rechner.
  </Card>

  <Card title="Uninstall" href="/install/uninstall" icon="trash-2">
    Entfernen Sie OpenClaw vollständig.
  </Card>
</CardGroup>