Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw liefert drei Installationsskripte aus, die von openclaw.ai bereitgestellt werden.
SkriptPlattformFunktion
install.shmacOS / Linux / WSLInstalliert bei Bedarf Node, installiert OpenClaw über npm (Standard) oder git und kann das Onboarding ausführen.
install-cli.shmacOS / Linux / WSLInstalliert Node + OpenClaw mit npm- oder git-Checkout-Modus in ein lokales Präfix (~/.openclaw). Kein root erforderlich.
install.ps1Windows (PowerShell)Installiert bei Bedarf Node, installiert OpenClaw über npm (Standard) oder git und kann das Onboarding ausführen.

​
Schnellbefehle

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

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --help
Wenn die Installation erfolgreich ist, openclaw aber in einem neuen Terminal nicht gefunden wird, lesen Sie Problembehandlung für Node.js.

​
install.sh

Empfohlen für die meisten interaktiven Installationen unter macOS/Linux/WSL.

​
Ablauf (install.sh)

1

Detect OS

Unterstützt macOS und Linux (einschließlich WSL). Wenn macOS erkannt wird, wird Homebrew installiert, falls es fehlt.
2

Ensure Node.js 24 by default

Prüft die Node-Version und installiert bei Bedarf Node 24 (Homebrew unter macOS, NodeSource-Setup-Skripte unter Linux apt/dnf/yum). Aus Kompatibilitätsgründen unterstützt OpenClaw weiterhin Node 22 LTS, derzeit 22.16+.
3

Ensure Git

Installiert Git, falls es fehlt.
4

Install OpenClaw

  • npm-Methode (Standard): globale npm-Installation
  • git-Methode: Repository klonen/aktualisieren, Abhängigkeiten mit pnpm installieren, bauen, dann Wrapper unter ~/.local/bin/openclaw installieren
5

Post-install tasks

  • Aktualisiert nach bestem Aufwand einen geladenen Gateway-Dienst (openclaw gateway install --force, dann Neustart)
  • Führt openclaw doctor --non-interactive bei Upgrades und git-Installationen aus (nach bestem Aufwand)
  • Versucht bei geeigneten Bedingungen das Onboarding (TTY verfügbar, Onboarding nicht deaktiviert und Bootstrap-/Konfigurationsprüfungen erfolgreich)
  • Setzt standardmäßig SHARP_IGNORE_GLOBAL_LIBVIPS=1

​
Erkennung eines Source-Checkouts

Wenn das Skript innerhalb eines OpenClaw-Checkouts ausgeführt wird (package.json + pnpm-workspace.yaml), bietet es Folgendes an:
  • Checkout verwenden (git) oder
  • globale Installation verwenden (npm)
Wenn kein TTY verfügbar ist und keine Installationsmethode festgelegt wurde, verwendet es standardmäßig npm und gibt eine Warnung aus. Das Skript beendet sich mit Code 2 bei ungültiger Methodenauswahl oder ungültigen --install-method-Werten.

​
Beispiele (install.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
FlagBeschreibung
--install-method npm|gitInstallationsmethode auswählen (Standard: npm). Alias: --method
--npmKurzbefehl für die npm-Methode
--gitKurzbefehl für die git-Methode. Alias: --github
--version <version|dist-tag|spec>npm-Version, dist-tag oder Paketangabe (Standard: latest)
--betaBeta-dist-tag verwenden, falls verfügbar, sonst Fallback auf latest
--git-dir <path>Checkout-Verzeichnis (Standard: ~/openclaw). Alias: --dir
--no-git-updategit pull für vorhandenen Checkout überspringen
--no-promptEingabeaufforderungen deaktivieren
--no-onboardOnboarding überspringen
--onboardOnboarding aktivieren
--dry-runAktionen ausgeben, ohne Änderungen anzuwenden
--verboseDebug-Ausgabe aktivieren (set -x, npm-Logs auf notice-Level)
--helpVerwendung anzeigen (-h)
VariableBeschreibung
OPENCLAW_INSTALL_METHOD=git|npmInstallationsmethode
OPENCLAW_VERSION=latest|next|main|<semver>|<spec>npm-Version, dist-tag oder Paketangabe
OPENCLAW_BETA=0|1Beta verwenden, falls verfügbar
OPENCLAW_GIT_DIR=<path>Checkout-Verzeichnis
OPENCLAW_GIT_UPDATE=0|1git-Aktualisierungen umschalten
OPENCLAW_NO_PROMPT=1Eingabeaufforderungen deaktivieren
OPENCLAW_NO_ONBOARD=1Onboarding überspringen
OPENCLAW_DRY_RUN=1Probelaufmodus
OPENCLAW_VERBOSE=1Debug-Modus
OPENCLAW_NPM_LOGLEVEL=error|warn|noticenpm-Log-Level
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1sharp/libvips-Verhalten steuern (Standard: 1)

​
install-cli.sh

Entwickelt für Umgebungen, in denen Sie alles unter einem lokalen Präfix (Standard ~/.openclaw) und ohne Systemabhängigkeit von Node haben möchten. Unterstützt standardmäßig npm-Installationen sowie git-Checkout-Installationen im selben Präfix-Ablauf.

​
Ablauf (install-cli.sh)

1

Install local Node runtime

Lädt ein fest gepinntes unterstütztes Node-LTS-Tarball (die Version ist im Skript eingebettet und wird unabhängig aktualisiert) nach <prefix>/tools/node-v<version> herunter und verifiziert SHA-256.
2

Ensure Git

Wenn Git fehlt, wird eine Installation über apt/dnf/yum unter Linux oder Homebrew unter macOS versucht.
3

Install OpenClaw under prefix

  • npm-Methode (Standard): installiert unter dem Präfix mit npm und schreibt dann den Wrapper nach <prefix>/bin/openclaw
  • git-Methode: klont/aktualisiert einen Checkout (Standard ~/openclaw) und schreibt den Wrapper dennoch nach <prefix>/bin/openclaw
4

Refresh loaded gateway service

Wenn ein Gateway-Dienst bereits aus demselben Präfix geladen ist, führt das Skript openclaw gateway install --force, dann openclaw gateway restart aus und prüft die Gateway-Integrität nach bestem Aufwand.

​
Beispiele (install-cli.sh)

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install-cli.sh | bash
FlagBeschreibung
--prefix <path>Installationspräfix (Standard: ~/.openclaw)
--install-method npm|gitInstallationsmethode auswählen (Standard: npm). Alias: --method
--npmKurzbefehl für die npm-Methode
--git, --githubKurzbefehl für die git-Methode
--git-dir <path>Git-Checkout-Verzeichnis (Standard: ~/openclaw). Alias: --dir
--version <ver>OpenClaw-Version oder dist-tag (Standard: latest)
--node-version <ver>Node-Version (Standard: 22.22.0)
--jsonNDJSON-Ereignisse ausgeben
--onboardNach der Installation openclaw onboard ausführen
--no-onboardOnboarding überspringen (Standard)
--set-npm-prefixUnter Linux npm-Präfix auf ~/.npm-global erzwingen, wenn das aktuelle Präfix nicht beschreibbar ist
--helpVerwendung anzeigen (-h)
VariableBeschreibung
OPENCLAW_PREFIX=<path>Installationspräfix
OPENCLAW_INSTALL_METHOD=git|npmInstallationsmethode
OPENCLAW_VERSION=<ver>OpenClaw-Version oder dist-tag
OPENCLAW_NODE_VERSION=<ver>Node-Version
OPENCLAW_GIT_DIR=<path>Git-Checkout-Verzeichnis für git-Installationen
OPENCLAW_GIT_UPDATE=0|1git-Updates für vorhandene Checkouts umschalten
OPENCLAW_NO_ONBOARD=1Onboarding überspringen
OPENCLAW_NPM_LOGLEVEL=error|warn|noticenpm-Protokollierungsstufe
SHARP_IGNORE_GLOBAL_LIBVIPS=0|1sharp/libvips-Verhalten steuern (Standard: 1)

​
install.ps1

​
Ablauf (install.ps1)

1

PowerShell- und Windows-Umgebung sicherstellen

Erfordert PowerShell 5+.
2

Standardmäßig Node.js 24 sicherstellen

Falls es fehlt, wird eine Installation über winget versucht, danach über Chocolatey, danach über Scoop. Node 22 LTS, derzeit 22.16+, bleibt aus Kompatibilitätsgründen unterstützt.
3

OpenClaw installieren

  • npm-Methode (Standard): globale npm-Installation mit dem ausgewählten -Tag, gestartet aus einem beschreibbaren temporären Installer-Verzeichnis, damit auch Shells funktionieren, die in geschützten Ordnern wie C:\ geöffnet wurden
  • git-Methode: Repo klonen/aktualisieren, mit pnpm installieren/builden und Wrapper unter %USERPROFILE%\.local\bin\openclaw.cmd installieren
4

Aufgaben nach der Installation

  • Fügt das benötigte bin-Verzeichnis nach Möglichkeit zum Benutzer-PATH hinzu
  • Aktualisiert nach bestem Bemühen einen geladenen Gateway-Dienst (openclaw gateway install --force, dann Neustart)
  • Führt openclaw doctor --non-interactive bei Upgrades und git-Installationen aus (nach bestem Bemühen)
5

Fehler behandeln

iwr ... | iex und Scriptblock-Installationen melden einen terminierenden Fehler, ohne die aktuelle PowerShell-Sitzung zu schließen. Direkte Installationen mit powershell -File / pwsh -File beenden sich für Automatisierung weiterhin mit einem Nicht-Null-Status.

​
Beispiele (install.ps1)

iwr -useb https://openclaw.ai/install.ps1 | iex
FlagBeschreibung
-InstallMethod npm|gitInstallationsmethode (Standard: npm)
-Tag <tag|version|spec>npm-dist-tag, Version oder Paketspezifikation (Standard: latest)
-GitDir <path>Checkout-Verzeichnis (Standard: %USERPROFILE%\openclaw)
-NoOnboardOnboarding überspringen
-NoGitUpdategit pull überspringen
-DryRunNur Aktionen ausgeben
VariableBeschreibung
OPENCLAW_INSTALL_METHOD=git|npmInstallationsmethode
OPENCLAW_GIT_DIR=<path>Checkout-Verzeichnis
OPENCLAW_NO_ONBOARD=1Onboarding überspringen
OPENCLAW_GIT_UPDATE=0git pull deaktivieren
OPENCLAW_DRY_RUN=1Testlaufmodus
Wenn -InstallMethod git verwendet wird und Git fehlt, beendet sich das Skript und gibt den Link zu Git for Windows aus.

​
CI und Automatisierung

Verwenden Sie nicht-interaktive Flags/Umgebungsvariablen für vorhersehbare Ausführungen. 
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash -s -- --no-prompt --no-onboard

​
Fehlerbehebung

Git ist für die git-Installationsmethode erforderlich. Bei npm-Installationen wird Git weiterhin geprüft/installiert, um spawn git ENOENT-Fehler zu vermeiden, wenn Abhängigkeiten git-URLs verwenden.
Einige Linux-Setups verweisen das globale npm-Präfix auf root-eigene Pfade. install.sh kann das Präfix auf ~/.npm-global umstellen und PATH-Exporte an Shell-rc-Dateien anhängen (wenn diese Dateien vorhanden sind).
Die Skripte setzen standardmäßig SHARP_IGNORE_GLOBAL_LIBVIPS=1, um zu vermeiden, dass sharp gegen das systemweite libvips gebaut wird. Zum Überschreiben:
SHARP_IGNORE_GLOBAL_LIBVIPS=0 curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
Installieren Sie Git for Windows, öffnen Sie PowerShell erneut und führen Sie den Installer erneut aus.
Führen Sie npm config get prefix aus und fügen Sie dieses Verzeichnis Ihrem Benutzer-PATH hinzu (unter Windows ist kein \bin-Suffix erforderlich), öffnen Sie danach PowerShell erneut.
install.ps1 stellt derzeit keinen -Verbose-Schalter bereit. Verwenden Sie PowerShell-Tracing für Diagnosen auf Skriptebene:
Set-PSDebug -Trace 1
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard
Set-PSDebug -Trace 0
In der Regel ist dies ein PATH-Problem. Siehe Node.js-Fehlerbehebung.

​
Verwandte Themen