Interne Funktionsweise des Installationsprogramms

Betriebssystem erkennen

Unterstützt macOS und Linux (einschließlich WSL).

Standardmäßig Node.js 24 sicherstellen

Prüft die Node-Version und installiert bei Bedarf Node 24 (Homebrew unter macOS, NodeSource-Einrichtungsskripte unter Linux mit apt/dnf/yum). Unter macOS wird Homebrew nur installiert, wenn das Installationsprogramm es für Node oder Git benötigt. Node 22.19+ und 23.11+ werden aus Kompatibilitätsgründen weiterhin unterstützt. Unter Alpine/musl Linux verwendet das Installationsprogramm apk-Pakete anstelle von NodeSource; die konfigurierten Alpine-Paketquellen müssen eine unterstützte Node-Version bereitstellen (zum Zeitpunkt der Erstellung Alpine 3.21 oder neuer).

Git sicherstellen

Installiert Git bei Bedarf über den erkannten Paketmanager, einschließlich Homebrew unter macOS und apk unter Alpine.

OpenClaw installieren

• Methode npm (Standard): globale Installation mit npm
• Methode git: Repository klonen/aktualisieren, Abhängigkeiten mit pnpm installieren, Build erstellen und anschließend den Wrapper unter ~/.local/bin/openclaw installieren

Aufgaben nach der Installation

• Ermittelt die soeben installierte openclaw-Binärdatei für nachfolgende Befehle
• Bei einer nicht konfigurierten Installation wird das Onboarding vor Doctor- oder Gateway-Prüfungen gestartet. Mit --no-onboard oder ohne TTY wird der Befehl ausgegeben, mit dem Sie die Einrichtung später abschließen können.
• Bei einer konfigurierten Installation wird ein geladener Gateway-Dienst nach bestem Bemühen aktualisiert und neu gestartet und anschließend Doctor ausgeführt. Bei Upgrades werden Plugins nach Möglichkeit aktualisiert; andernfalls wird bei einer nicht interaktiven Ausführung mit aktivierten Eingabeaufforderungen der manuelle Befehl ausgegeben.
• Wenn --verify ausgeführt wird, prüft das Skript die installierte Version und den Zustand des Gateways nur, wenn bereits eine Konfiguration vorhanden ist.

Lokale Node-Laufzeit installieren

Lädt ein festgelegtes unterstütztes Node-LTS-Tarball (die Version ist im Skript eingebettet und wird unabhängig aktualisiert, Standard: 22.22.2) nach <prefix>/tools/node-v<version> herunter und überprüft SHA-256. Unter Alpine/musl Linux, für das Node keine kompatiblen Tarballs für die festgelegte Laufzeit veröffentlicht, werden nodejs und npm mit apk installiert und diese Laufzeit mit dem Wrapper-Pfad des Präfixes verknüpft. Die Alpine-Paketquellen müssen eine unterstützte Node-Version bereitstellen (22.19+, 23.11+ oder 24+); verwenden Sie Alpine 3.21 oder neuer, wenn ältere Paketquellen nur Node 20 oder 21 bereitstellen.

Git sicherstellen

Wenn Git fehlt, wird versucht, es unter Linux über apt/dnf/yum/apk oder unter macOS über Homebrew zu installieren.

OpenClaw unter dem Präfix installieren

• Methode npm (Standard): installiert OpenClaw mit npm unter dem Präfix und schreibt anschließend den Wrapper nach <prefix>/bin/openclaw
• Methode git: klont/aktualisiert einen Checkout (Standard: ~/openclaw) und schreibt den Wrapper ebenfalls nach <prefix>/bin/openclaw

Geladenen Gateway-Dienst aktualisieren

Wenn bereits ein Gateway-Dienst aus demselben Präfix geladen ist, führt das Skript openclaw gateway install --force und anschließend openclaw gateway restart aus und prüft den Zustand des Gateways nach bestem Bemühen.

PowerShell- und Windows-Umgebung sicherstellen

Erfordert PowerShell 5 oder höher.

Standardmäßig Node.js 24 sicherstellen

Falls Node.js fehlt, wird zunächst die Installation über winget, dann über Chocolatey und anschließend über Scoop versucht. Wenn kein Paketmanager verfügbar ist, lädt das Skript die offizielle ZIP-Datei von Node.js 24 für Windows nach %LOCALAPPDATA%\OpenClaw\deps\portable-node herunter und fügt das Verzeichnis dem PATH des aktuellen Prozesses und des Benutzers hinzu. Node 22.19 oder höher sowie 23.11 oder höher werden aus Kompatibilitätsgründen weiterhin unterstützt.

OpenClaw installieren

• npm-Methode (Standard): globale npm-Installation mit dem ausgewählten -Tag, ausgeführt aus einem beschreibbaren temporären Installationsverzeichnis, damit auch Shells funktionieren, die in geschützten Ordnern wie C:\ geöffnet wurden
• git-Methode: Repository klonen oder aktualisieren, mit pnpm installieren und erstellen sowie den Wrapper unter %USERPROFILE%\.local\bin\openclaw.cmd installieren. Falls Git fehlt, richtet das Skript eine benutzerlokale MinGit-Installation unter %LOCALAPPDATA%\OpenClaw\deps\portable-git ein und fügt sie dem PATH des aktuellen Prozesses und des Benutzers hinzu.

Aufgaben nach der Installation

• Fügt das erforderliche Binärverzeichnis nach Möglichkeit dem Benutzer-PATH hinzu
• Aktualisiert nach bestem Bemühen einen geladenen Gateway-Dienst (openclaw gateway install --force, anschließend Neustart)
• Führt bei Upgrades und Git-Installationen openclaw doctor --non-interactive aus (nach bestem Bemühen)

Fehler behandeln

Installationen über iwr ... | iex und Skriptblöcke melden einen terminierenden Fehler, ohne die aktuelle PowerShell-Sitzung zu schließen. Direkte Installationen über powershell -File / pwsh -File werden für Automatisierungszwecke weiterhin mit einem von null verschiedenen Statuscode beendet.