docs/docs/de/install/index.md
2026-04-26 11:44:02 +00:00

7.1 KiB

read_when summary title x-i18n
Sie benötigen eine andere Installationsmethode als den Schnellstart unter „Erste Schritte“.
Sie möchten auf einer Cloud-Plattform bereitstellen.
Sie müssen aktualisieren, migrieren oder deinstallieren.
OpenClaw installieren — Installer-Skript, npm/pnpm/bun, aus dem Quellcode, Docker und mehr Installation
generated_at model provider source_hash source_path workflow
2026-04-26T11:32:45Z gpt-5.4 openai b8dc6b9511be6bf9060cc150a7c51daf3b6d556dab4a85910094b4b892145cd7 install/index.md 15

Systemanforderungen

  • Node 24 (empfohlen) oder Node 22.14+ — das Installer-Skript ü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: Installer-Skript

Der schnellste Weg zur Installation. Es erkennt Ihr Betriebssystem, installiert bei Bedarf Node, installiert OpenClaw und startet das Onboarding.

```bash curl -fsSL https://openclaw.ai/install.sh | bash ``` ```powershell iwr -useb https://openclaw.ai/install.ps1 | iex ```

Installation ohne Onboarding:

```bash curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard ``` ```powershell & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard ```

Alle Flags sowie Optionen für CI/Automatisierung finden Sie unter Installer internals.

Alternative Installationsmethoden

Installer mit lokalem Präfix (install-cli.sh)

Verwenden Sie dies, wenn Sie OpenClaw und Node unter einem lokalen Präfix wie ~/.openclaw halten möchten, ohne von einer systemweiten Node-Installation abhängig zu sein:

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

Standardmäßig unterstützt es npm-Installationen sowie Installationen aus einem Git-Checkout innerhalb desselben Präfix-Flows. Vollständige Referenz: Installer internals.

Bereits installiert? Wechseln Sie zwischen Paket- und Git-Installationen mit openclaw update --channel dev und openclaw update --channel stable. Siehe Aktualisieren.

npm, pnpm oder bun

Wenn Sie Node bereits selbst verwalten:

```bash npm install -g openclaw@latest openclaw onboard --install-daemon ``` ```bash pnpm add -g openclaw@latest pnpm approve-builds -g openclaw onboard --install-daemon ```
<Note>
pnpm erfordert eine explizite Genehmigung für Pakete mit Build-Skripten. Führen Sie nach der ersten Installation `pnpm approve-builds -g` aus.
</Note>
```bash bun add -g openclaw@latest openclaw onboard --install-daemon ```
<Note>
Bun wird für den globalen CLI-Installationspfad unterstützt. Für die Gateway-Laufzeit bleibt Node die empfohlene Daemon-Laufzeit.
</Note>
Wenn `sharp` aufgrund eines 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 heraus arbeiten 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 Linken und verwenden Sie pnpm openclaw ... innerhalb des Repositorys. Vollständige Entwicklungs-Workflows finden Sie unter Setup.

Von GitHub main installieren

npm install -g github:openclaw/openclaw#main

Container und Paketmanager

Containerisierte oder headless Deployments. Rootless-Container-Alternative zu Docker. Deklarative Installation über Nix Flake. Automatisierte Bereitstellung für Flotten. Nur-CLI-Nutzung über die Bun-Laufzeit.

Installation überprüfen

openclaw --version      # prüfen, ob die CLI verfügbar ist
openclaw doctor         # auf Konfigurationsprobleme prüfen
openclaw gateway status # prüfen, ob das Gateway läuft

Wenn Sie nach der Installation einen verwalteten Start möchten:

  • macOS: LaunchAgent über openclaw onboard --install-daemon oder openclaw gateway install
  • Linux/WSL2: systemd-Benutzerdienst über dieselben Befehle
  • Natives Windows: zuerst Scheduled Task, mit Fallback auf ein Login-Element im benutzerspezifischen Startup-Ordner, falls die Task-Erstellung verweigert wird

Hosting und Bereitstellung

Stellen Sie OpenClaw auf einem Cloud-Server oder VPS bereit:

Beliebiger Linux-VPS Gemeinsame Docker-Schritte K8s Fly.io Hetzner Google Cloud Azure Railway Render Northflank

Aktualisieren, migrieren oder deinstallieren

OpenClaw aktuell halten. Auf einen neuen Rechner umziehen. OpenClaw vollständig entfernen.

Fehlerbehebung: openclaw nicht gefunden

Wenn die Installation erfolgreich war, openclaw aber in Ihrem Terminal nicht gefunden wird:

node -v           # Ist Node installiert?
npm prefix -g     # Wo sind globale Pakete?
echo "$PATH"      # Ist das globale bin-Verzeichnis 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 dann ein neues Terminal. Weitere Details finden Sie unter Node setup.