2026 OpenClaw unter Windows: reproduzierbares PowerShell-Setup, WSL2-Vergleich, Gateway-Dauerbetrieb und gestufte PATH-/doctor-FAQ

Windows bleibt ein verbreiteter Desktop für GUI-lastige Rollen. CLI, optionales Gateway und tokenbasierte Kanäle von OpenClaw lassen sich gut betreiben, sobald PATH, Rechte und die Frage „wer startet den Dienst?“ schriftlich festliegen. Dieser Text fokussiert reproduzierbare Installationen: PowerShell-Skriptmuster, WSL2-Abwägungen, wie sich Gateway-Dauerbetrieb von Linux mit systemd unterscheidet, sowie eine gestufte PATH- und doctor-Triage, damit Tickets hostübergreifend vergleichbar bleiben.

Reproduzierbare Installation: PowerShell-Ein-Klick-Muster

Der Happy Path gehört in ein Skript mit fixierten Annahmen: Ausführungsrichtlinie für die aktuelle Sitzung, dediziertes Installationsverzeichnis, eine Node-Hauptversion und ein append-only-Log. Idempotenz schlägt Kürze — Nachläufe nach Teilfehlern dürfen PATH nicht doppeln oder parallele Kopien verwaisten lassen.

# Windows PowerShell 5.1 oder pwsh — in der Doku eine Variante wählen und dabei bleiben
$ErrorActionPreference = 'Stop'
$installRoot = "$env:LOCALAPPDATA\openclaw-toolchain"
$log = "$installRoot\install.log"
New-Item -ItemType Directory -Force -Path $installRoot | Out-Null
"--- $(Get-Date -Format o) ---" | Out-File -FilePath $log -Append
# Prüfsumme / Entpacken genau hier — danach:
$bin = "$installRoot\current\bin"
$userPath = [Environment]::GetEnvironmentVariable('Path','User')
if ($userPath -notlike "*$bin*") {
  [Environment]::SetEnvironmentVariable('Path', "$userPath;$bin", 'User')
}

Dokumentieren Sie, ob Betrieb nach PATH-Änderung ein neues Terminal braucht — viele „CLI verschwunden“-Tickets sind alte Handles. Ein kleines Manifest (Node-Hauptversion, OpenClaw-Build-ID, Gateway-Port) reicht, damit Support Hosts ohne Anruf vergleichen kann.

PowerShell unter Windows vs. WSL2: wo OpenClaw laufen soll

WSL2 bietet einen Linux-artigen Baum und Syscalls; curl | bash-Beispiele wirken vertraut. Sie zahlen mit Split-DNS, Extra-Hop und zwei PATH-Universen: Erfolg in Ubuntu bedeutet nicht, dass eine Windows-Taskplaner-Aufgabe mit der Win32-Binary identisch reagiert. Pro Rolle eine primäre Laufzeit wählen — z. B. natives Windows für Desk-Operator, WSL2 nur für Teams, die ohnehin container-first arbeiten.

Zur Parität mit dem, was wir auf Servern ausliefern, eignet sich unser Linux-VPS-Leitfaden: 2026 OpenClaw Linux-Cloud-VPS in der Praxis: curl-Installation vs. Docker, Umgebungschecks und FAQ zu typischen Fehlern.

Gateway-Dauerbetrieb: Windows ist nicht Linux

Unter Linux ist Always-on-Gateway meist systemd mit Restart=on-failure und journald. Windows nutzt SCM, Aufgabenplanung oder Wrapper — jeweils mit anderen Anmeldeinformationen, Arbeitsverzeichnis und Umgebungsblöcken. Typische Falle: Dienst als LOCAL SERVICE ohne denselben Benutzer-PATH, den der Admin in einer erhöhten PowerShell getestet hat.

Dieselbe Checkliste: Binärpfad, Konfigpfad, beschreibbares Datenverzeichnis, Bind-Interface, ausgehendes HTTPS, ACLs für Token-Dateien. Für HTTPS, onboard, doctor und Rollbacks auf Linux siehe 2026 OpenClaw Gateway in Produktion auf Linux: openclaw onboard, openclaw doctor und --fix, HTTPS mit Nginx oder Caddy, Upgrade und Rollback; unter Windows ersetzen Sie journald durch Ereignisprotokoll, Aufgabenverlauf und Logs, die Sie selbst verdrahten.

PATH und doctor: gestufte Triage für vergleichbare Tickets

Wir labeln Schritte L0–L3, damit zwei Engineer denselben Ticketzustand sehen. L0: welche Shell — Profil, Elevation, WSL vs. PowerShell-Tab. L1: Get-Command openclaw / where.exe openclaw plus openclaw --version. L2: mitgelieferte doctor-Checks — Konfigpfad, Node-ABI, ausgehende Probe, optionaler Bind-Selbsttest. L3: redigierte Umgebung, Firewall-Auszug, letzte 200 Zeilen des Installationslogs.

Versionieren Sie doctor-Schweregrade im Runbook, wenn Checks von Warnung zu Fehler wechseln — Dashboards bleiben konsistent. Auf domänenverbundenen PCs GPOs notieren, die PATH umschreiben — allein das erklärt viele „Freitag ging es noch“-Regressionen.