Installieren

Nutze den Installer, es sei denn, du hast einen guten Grund dagegen. Er richtet die CLI ein und startet das Onboarding.

Schnellinstallation (empfohlen)

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

Windows (PowerShell):

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

Nächster Schritt (falls du das Onboarding übersprungen hast):

openclaw onboard --install-daemon

Systemanforderungen

  • Node >=22
  • macOS, Linux oder Windows via WSL2
  • pnpm nur, wenn du aus dem Quellcode baust

Wähle deinen Installationsweg

1) Installer-Skript (empfohlen)

Installiert openclaw global via npm und startet das Onboarding.

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

Installer-Flags:

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

Details: Installer-Interna.

Nicht-interaktiv (Onboarding überspringen):

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

2) Globale Installation (manuell)

Falls du Node bereits hast:

npm install -g openclaw@latest

Falls du libvips global installiert hast (häufig auf macOS via Homebrew) und sharp nicht installiert werden kann, erzwinge vorkompilierte Binaries:

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

Falls du sharp: Please add node-gyp to your dependencies siehst, installiere entweder die Build-Tools (macOS: Xcode CLT + npm install -g node-gyp) oder nutze den SHARP_IGNORE_GLOBAL_LIBVIPS=1 Workaround oben, um den nativen Build zu überspringen.

Oder mit pnpm:

pnpm add -g openclaw@latest
pnpm approve-builds -g                # openclaw, node-llama-cpp, sharp usw. genehmigen
pnpm add -g openclaw@latest           # erneut ausführen, um postinstall-Skripte auszuführen

pnpm erfordert eine explizite Genehmigung für Pakete mit Build-Skripten. Nachdem die erste Installation die Warnung “Ignored build scripts” zeigt, führe pnpm approve-builds -g aus, wähle die aufgelisteten Pakete und führe die Installation erneut aus, damit die postinstall-Skripte ausgeführt werden.

Dann:

openclaw onboard --install-daemon

3) Aus dem Quellcode (Contributors/Entwickler)

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # installiert UI-Abhängigkeiten automatisch beim ersten Lauf
pnpm build
openclaw onboard --install-daemon

Tipp: Falls du noch keine globale Installation hast, führe Repo-Befehle via pnpm openclaw ... aus.

4) Weitere Installationsoptionen

Nach der Installation

  • Onboarding starten: openclaw onboard --install-daemon
  • Schnellcheck: openclaw doctor
  • Gateway-Status prüfen: openclaw status + openclaw health
  • Dashboard öffnen: openclaw dashboard

Installationsmethode: npm vs git (Installer)

Der Installer unterstützt zwei Methoden:

  • npm (Standard): npm install -g openclaw@latest
  • git: von GitHub clonen/bauen und aus einem Source-Checkout ausführen

CLI-Flags

# Explizit npm
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method npm

# Von GitHub installieren (Source-Checkout)
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

Häufige Flags:

  • --install-method npm|git
  • --git-dir <path> (Standard: ~/openclaw)
  • --no-git-update (git pull überspringen bei bestehendem Checkout)
  • --no-prompt (Prompts deaktivieren; erforderlich in CI/Automation)
  • --dry-run (zeigt was passieren würde; keine Änderungen)
  • --no-onboard (Onboarding überspringen)

Umgebungsvariablen

Äquivalente Umgebungsvariablen (nützlich für Automation):

  • OPENCLAW_INSTALL_METHOD=git|npm
  • OPENCLAW_GIT_DIR=...
  • OPENCLAW_GIT_UPDATE=0|1
  • OPENCLAW_NO_PROMPT=1
  • OPENCLAW_DRY_RUN=1
  • OPENCLAW_NO_ONBOARD=1
  • SHARP_IGNORE_GLOBAL_LIBVIPS=0|1 (Standard: 1; verhindert, dass sharp gegen System-libvips baut)

Troubleshooting: openclaw nicht gefunden (PATH)

Schnelldiagnose:

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

Falls $(npm prefix -g)/bin (macOS/Linux) oder $(npm prefix -g) (Windows) nicht in echo "$PATH" enthalten ist, kann deine Shell globale npm-Binaries (einschließlich openclaw) nicht finden.

Lösung: Füge es zu deiner Shell-Startup-Datei hinzu (zsh: ~/.zshrc, bash: ~/.bashrc):

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

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

Dann öffne ein neues Terminal (oder rehash in zsh / hash -r in bash).

Aktualisieren / Deinstallieren