Windows

OpenClaw umfasst eine native Windows Hub-Begleit-App sowie Windows-CLI-Unterstützung. Verwenden Sie Windows Hub für eine Desktop-App mit Einrichtung, Taskleistenstatus, Chat, Diagnosen im Command Center und Windows-Node-Funktionen. Verwenden Sie das PowerShell-Installationsprogramm direkt für CLI/Gateway. Verwenden Sie WSL2 für die Linux-kompatibelste Gateway-Laufzeitumgebung.

Empfohlen: Windows Hub

Windows Hub ist die native WinUI-Begleit-App für Windows 10 20H2+ und Windows 11. Sie wird ohne Administratorrechte installiert und bietet signierte x64- und ARM64-Installationsprogramme auf einer eigenen Release-Seite.

Windows Hub wird unabhängig von OpenClaw CLI und Gateway veröffentlicht. Laden Sie das neueste stabile Hub-Installationsprogramm von der Windows-Hub-Release-Seite oder direkt über releases/latest/download herunter:

• OpenClawCompanion-Setup-x64.exe
• OpenClawCompanion-Setup-arm64.exe

Wenn einer der obigen Links einen 404-Fehler zurückgibt, besuchen Sie die Windows-Hub-Release-Seite und öffnen Sie das neueste stabile Windows-Hub-Release. Reguläre stabile OpenClaw-Releases spiegeln außerdem einen festgelegten, für das Release validierten Windows-Hub-Build; diese Spiegelung kann einem neueren eigenständigen Hub-Release hinterherhinken.

Starten Sie nach der Installation OpenClaw Companion über das Startmenü oder die Taskleiste. Das Installationsprogramm fügt außerdem Verknüpfungen für Gateway Setup, Chat, Settings, Check for Updates und die Deinstallation hinzu.

Inhalt von Windows Hub

• Taskleistenstatus und Start bei der Anmeldung.
• Ersteinrichtung für ein lokales, von der App verwaltetes WSL-Gateway.
• Verbindungseinstellungen für lokale, entfernte und über SSH-Tunnel erreichbare Gateways.
• Natives Chatfenster sowie Zugriff auf die browserbasierte Control UI.
• Diagnosen im Command Center für Sitzungen, Nutzung, Kanäle, Nodes, Kopplung und Reparaturbefehle.
• Windows-Node-Modus für agentengesteuerte Canvas-, Bildschirm- und Kamerafunktionen, Benachrichtigungen, Gerätestatus, Sprachfunktionen und kontrolliertes system.run.
• Lokaler MCP-Servermodus für MCP-Clients wie Claude Desktop, Claude Code und Cursor.

Erster Start

Beim ersten Start öffnet Windows Hub die Einrichtung, wenn kein verwendbares gespeichertes Gateway vorhanden ist. Der schnellste Weg ist Set up locally. Dabei wird eine von der App verwaltete OpenClawGateway-WSL-Distribution bereitgestellt, das Gateway darin installiert und die App gekoppelt. Ihre vorhandene Ubuntu-Distribution wird dadurch weder exportiert noch verändert.

Wählen Sie Advanced setup oder öffnen Sie die Registerkarte Connections, wenn Sie bereits über ein Gateway verfügen. Sie können eine Verbindung herstellen zu:

• einem lokalen Gateway auf diesem PC
• einem WSL-Gateway auf diesem PC
• einem entfernten Gateway über URL und Token oder Einrichtungscode
• einem über einen SSH-Tunnel erreichbaren Gateway

Nach Abschluss der Einrichtung wird das Taskleistensymbol grün. Öffnen Sie Command Center über die Taskleiste, um Verbindung, Kopplung, Node-Status und Kanalstatus zu überprüfen.

Windows-Node-Modus

Windows Hub kann sich als OpenClaw-Node registrieren, damit der Agent deklarierte Windows-native Funktionen über das Gateway verwenden kann. Node-Befehle müssen vom Node deklariert und durch die Gateway-Richtlinie erlaubt sein, bevor sie ausgeführt werden; das vollständige Zulassungs-/Ablehnungsmodell finden Sie unter Nodes.

Häufig verwendete Befehle:

Der Node-Modus erfordert eine Gateway-Kopplung. Wenn die App eine Kopplungsanfrage anzeigt, genehmigen Sie sie auf dem Gateway-Host:

openclaw devices listopenclaw devices approve <requestId>openclaw nodes status

Das Gateway leitet nur Befehle weiter, die der Node deklariert und die Serverrichtlinie erlaubt. Datenschutzkritische Befehle wie screen.record, camera.snap und camera.clip müssen ausdrücklich über gateway.nodes.allowCommands aktiviert werden.

Lokaler MCP-Modus

Windows Hub kann dieselbe Windows-native Funktionsregistrierung als lokalen MCP-Server auf der Loopback-Schnittstelle bereitstellen. Dadurch können lokale MCP-Clients Windows-Funktionen ohne laufendes OpenClaw Gateway steuern.

Aktivieren Sie ihn in den Windows-Hub-Einstellungen im Entwickler-/erweiterten Bereich. Die App zeigt den Loopback-Endpunkt und das Bearer-Token an, sobald der Server aktiviert ist.

Modusmatrix:

Native Windows-CLI und Gateway

Installieren Sie OpenClaw für eine primär terminalbasierte Nutzung über PowerShell:

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

Überprüfen Sie die Installation:

openclaw --versionopenclaw doctoropenclaw gateway status --json

Der verwaltete Start verwendet Windows Scheduled Tasks, sofern verfügbar. Die Aufgabe behält das lesbare Skript gateway.cmd im OpenClaw-Statusverzeichnis bei, startet es jedoch über einen generierten gateway.vbs-WScript-Wrapper, sodass das im Hintergrund laufende Gateway kein sichtbares Konsolenfenster öffnet. Wenn die Aufgabenerstellung verweigert wird, wechselt OpenClaw ersatzweise zu einem benutzerspezifischen Anmeldeelement im Autostartordner.

Installieren Sie den Gateway-Dienst:

openclaw gateway installopenclaw gateway status --json

Für eine ausschließliche CLI-Nutzung ohne verwalteten Gateway-Dienst:

openclaw onboard --non-interactive --skip-healthopenclaw gateway run

WSL2-Gateway

WSL2 bleibt die Linux-kompatibelste Gateway-Laufzeitumgebung unter Windows. Windows Hub kann ein von der App verwaltetes WSL-Gateway für Sie einrichten, oder Sie können es manuell in Ihrer eigenen Distribution installieren.

Manuelle Einrichtung:

wsl --install# Oder wählen Sie explizit eine Distribution aus:wsl --list --onlinewsl --install -d Ubuntu-24.04

Aktivieren Sie systemd innerhalb von WSL:

sudo tee /etc/wsl.conf >/dev/null <<'EOF'[boot]systemd=trueEOF

Starten Sie WSL über PowerShell neu:

wsl --shutdown

Installieren Sie anschließend OpenClaw innerhalb von WSL mit der Linux-Schnellstartanleitung:

curl -fsSL https://openclaw.ai/install.sh | bashopenclaw gateway status

Automatischer Gateway-Start vor der Windows-Anmeldung

Stellen Sie bei monitorlosen WSL-Einrichtungen sicher, dass die gesamte Startkette ausgeführt wird, selbst wenn sich niemand bei Windows anmeldet.

Innerhalb von WSL:

sudo apt-get install -y dbus-x11sudo loginctl enable-linger "$(whoami)"openclaw gateway install

In PowerShell als Administrator:

schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec dbus-launch true" /sc onstart /ru "$env:USERNAME"

Ersetzen Sie Ubuntu durch den Namen Ihrer Distribution aus:

wsl --list --verbose

Überprüfen Sie nach dem Neustart innerhalb von WSL:

systemctl --user is-enabled openclaw-gateway.servicesystemctl --user status openclaw-gateway.service --no-pager

WSL-Dienste im LAN bereitstellen

WSL verfügt über ein eigenes virtuelles Netzwerk. Wenn ein anderer Computer einen Dienst innerhalb von WSL erreichen muss, leiten Sie einen Windows-Port an die aktuelle WSL-IP-Adresse weiter. Die WSL-IP-Adresse kann sich nach Neustarts ändern. Aktualisieren Sie daher bei Bedarf die Weiterleitungsregel.

Beispiel in PowerShell als Administrator:

$Distro = "Ubuntu-24.04"$ListenPort = 2222$TargetPort = 22 $WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]if (-not $WslIp) { throw "WSL-IP nicht gefunden." } netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `  connectaddress=$WslIp connectport=$TargetPort New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `  -Protocol TCP -LocalPort $ListenPort -Action Allow

Hinweise:

• SSH-Verbindungen von einem anderen Computer verwenden die IP-Adresse des Windows-Hosts als Ziel, beispielsweise ssh user@windows-host -p 2222.
• Entfernte Nodes müssen auf eine erreichbare Gateway-URL verweisen, nicht auf 127.0.0.1.
• Verwenden Sie listenaddress=0.0.0.0 für LAN-Zugriff und 127.0.0.1 für ausschließlich lokalen Zugriff.

Fehlerbehebung

Das Taskleistensymbol wird nicht angezeigt

Suchen Sie im Task-Manager nach OpenClaw.Tray.WinUI.exe. Wenn der Prozess ausgeführt wird, öffnen Sie den Bereich für ausgeblendete Taskleistensymbole und heften Sie das Symbol an. Andernfalls starten Sie OpenClaw Companion über das Startmenü.

Die lokale Einrichtung schlägt fehl

Öffnen Sie das Einrichtungsprotokoll über Windows Hub oder untersuchen Sie:

notepad "$env:LOCALAPPDATA\OpenClawTray\Logs\Setup\easy-setup-latest.txt"

Häufige Ursachen sind deaktiviertes WSL, blockierte Virtualisierung, ein veralteter von der App verwalteter WSL-Status oder ein Netzwerkfehler bei der Installation des Gateway-Pakets.

Die App meldet, dass eine Kopplung erforderlich ist

Genehmigen Sie die Bediener- oder Node-Anfrage über das Gateway:

openclaw devices listopenclaw devices approve <requestId>

Wenn das Gerät bereits über ein Token verfügte, stellen Sie nach der Genehmigung über die Registerkarte Connections erneut eine Verbindung her.

Der Webchat kann ein entferntes Gateway nicht erreichen

Ein entfernter Webchat benötigt HTTPS oder localhost. Vertrauen Sie bei selbstsignierten Zertifikaten dem Zertifikat in Windows, oder verwenden Sie einen SSH-Tunnel zu einer localhost-URL.

screen.snapshot-, Kamera- oder Audiobefehle schlagen fehl

Überprüfen Sie die Windows-Berechtigungen für Kamera, Mikrofon, Bildschirmaufnahme und Benachrichtigungen. Paketierte Installationen deklarieren die geschützten Funktionen, Windows kann jedoch bei der ersten Verwendung durch einen Befehl weiterhin eine Bestätigung anfordern.

Git- oder GitHub-Verbindungen schlagen fehl

Einige Netzwerke blockieren oder drosseln HTTPS-Verbindungen zu GitHub. Wenn git clone oder gh auth login fehlschlägt, versuchen Sie es über ein anderes Netzwerk, ein VPN oder einen HTTP-/HTTPS-Proxy.

Für eine Token-basierte gh-Authentifizierung in der aktuellen Sitzung:

$env:GH_TOKEN="<your-token>"gh auth statusgh auth setup-git

Übertragen Sie Tokens niemals in ein Repository und fügen Sie sie niemals in Issues oder Pull Requests ein.

Verwandte Themen

• Installationsübersicht
• Node.js-Einrichtung
• Nodes
• Control UI
• Gateway-Konfiguration