Interna 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-Setup-Skripte 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.22.3+, Node 24.15+ und Node 25.9+ werden unterstützt; Node 23 wird nicht unterstützt. Unter Alpine/musl Linux verwendet das Installationsprogramm anstelle von NodeSource apk-Pakete und überprüft die tatsächlich verknüpfte SQLite-Version. Aktuelle stabile Alpine-Paketquellen können eine ausreichend neue Node-Version mit einer anfälligen Systemversion von SQLite bereitstellen; verwenden Sie in diesem Fall stattdessen einen offiziellen node:24-alpine-Container oder einen glibc-basierten Host.

Git sicherstellen

Installiert Git bei Bedarf mit dem erkannten Paketmanager, einschließlich Homebrew unter macOS und apk unter Alpine.

OpenClaw installieren

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

Aufgaben nach der Installation

• Ermittelt die soeben installierte Binärdatei openclaw 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 die Einrichtung später abgeschlossen werden kann.
• 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; alternativ wird bei einer Headless-Ausführung mit aktivierten Eingabeaufforderungen der manuelle Befehl ausgegeben.
• Wenn --verify ausgeführt wird, prüft es die installierte Version und den Zustand des Gateways erst, nachdem eine Konfiguration vorhanden ist.

Lokale Node-Laufzeit installieren

Lädt ein angeheftetes, unterstütztes Node-LTS-Tarball (die Version ist im Skript eingebettet und wird unabhängig aktualisiert, Standard: 24.15.0) nach <prefix>/tools/node-v<version> herunter und überprüft SHA-256. Linux ARMv7 verwendet Node 22.22.3, da keine offiziellen Binärdateien für Node 24+ unter ARMv7 verfügbar sind. Unter Alpine/musl Linux, für das Node keine kompatiblen Tarballs für die angeheftete Laufzeit veröffentlicht, werden nodejs und npm mit apk installiert; anschließend werden sowohl Node als auch die tatsächlich verknüpfte SQLite-Bibliothek überprüft. Aktuelle stabile Alpine-Paketquellen können selbst mit einer ausreichend neuen Node-Version weiterhin eine anfällige SQLite-Version verknüpfen; verwenden Sie einen offiziellen node:24-alpine-Container oder einen glibc-basierten Host, wenn die Sicherheitsprüfung das Paket ablehnt.

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

• npm-Methode (Standard): installiert mit npm unter dem Präfix und schreibt anschließend den Wrapper nach <prefix>/bin/openclaw
• git-Methode: 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 aus, wodurch der Ersatzdienst aktiviert wird, und prüft anschließend nach bestem Bemühen den Zustand des Gateways.

PowerShell- und Windows-Umgebung sicherstellen

Erfordert PowerShell 5+.

Standardmäßig Node.js 24 sicherstellen

Falls nicht vorhanden, wird die Installation zunächst über winget, dann über Chocolatey und anschließend über Scoop versucht. Wenn kein Paketmanager verfügbar ist, lädt das Skript die offizielle Windows-ZIP-Datei von Node.js 24 nach %LOCALAPPDATA%\OpenClaw\deps\portable-node herunter und fügt sie dem PATH des aktuellen Prozesses und des Benutzers hinzu. Node 22.22.3+, Node 24.15+ und Node 25.9+ werden unterstützt; Node 23 wird nicht unterstützt.

OpenClaw installieren

• npm-Methode (Standard): globale npm-Installation mit dem ausgewählten -Tag, gestartet aus einem beschreibbaren temporären Installationsverzeichnis, damit auch Shells funktionieren, die in geschützten Ordnern wie C:\ geöffnet wurden
• git-Methode: Repository klonen/aktualisieren, mit pnpm installieren/erstellen und Wrapper unter %USERPROFILE%\.local\bin\openclaw.cmd installieren. Falls Git fehlt, richtet das Skript benutzerlokales MinGit unter %LOCALAPPDATA%\OpenClaw\deps\portable-git ein und fügt es 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 einen geladenen Gateway-Dienst nach bestem Bemühen (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

iwr ... | iex- und Skriptblockinstallationen melden einen beendenden Fehler, ohne die aktuelle PowerShell-Sitzung zu schließen. Direkte Installationen über powershell -File / pwsh -File werden für Automatisierungen weiterhin mit einem Exitcode ungleich null beendet.