Windows

OpenClaw wird mit einer nativen Begleitanwendung namens Windows Hub sowie Windows-CLI-Unterstützung ausgeliefert. Verwenden Sie Windows Hub für eine Desktopanwendung mit Einrichtung, Taskleistenstatus, Chat, Diagnosefunktionen im Command Center und Windows-Node-Funktionen. Verwenden Sie das PowerShell- Installationsprogramm direkt für CLI/Gateway. Verwenden Sie WSL2 für die am stärksten Linux-kompatible Gateway-Laufzeitumgebung.

Empfohlen: Windows Hub

Windows Hub ist die native WinUI-Begleitanwendung für Windows 10 20H2+ und Windows 11. Sie wird ohne Administratorrechte installiert und stellt signierte x64- und ARM64-Installationsprogramme auf ihrer eigenen Release-Seite bereit.

Windows Hub wird unabhängig von der OpenClaw-CLI und dem 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 gegenüber einem neueren eigenständigen Hub-Release verzögert sein.

Starten Sie nach der Installation OpenClaw Companion über das Startmenü oder den Infobereich. 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

• Status im Infobereich und Start bei der Anmeldung.
• Ersteinrichtung für ein lokales, anwendungseigenes WSL-Gateway.
• Verbindungseinstellungen für lokale, entfernte und über SSH getunnelte Gateways.
• Natives Chatfenster sowie Zugriff auf die browserbasierte Control UI.
• Diagnosefunktionen 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, Sprachausgabe 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 anwendungseigene OpenClawGateway-WSL-Distribution bereitgestellt, das Gateway darin installiert und die Anwendung gekoppelt. Ihre vorhandene Ubuntu-Distribution wird dabei 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 per URL und Token oder Einrichtungscode
• einem über einen SSH-Tunnel erreichbaren Gateway

Nach Abschluss der Einrichtung wird das Symbol im Infobereich grün. Öffnen Sie Command Center über den Infobereich, um Verbindung, Kopplung, Node-Status und Kanalzustand zu überprüfen.

Windows-Node-Modus

Windows Hub kann sich als OpenClaw-Node registrieren, sodass der Agent deklarierte native Windows-Funktionen über das Gateway verwenden kann. Node-Befehle müssen vom Node deklariert und durch die Gateway-Richtlinie zugelassen 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 Anwendung 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 zulässt. Datenschutzrelevante Befehle wie screen.record, camera.snap und camera.clip benötigen eine ausdrückliche gateway.nodes.commands.allow-Aktivierung.

Lokaler MCP-Modus

Windows Hub kann dieselbe Registry nativer Windows-Funktionen als lokalen MCP-Server über die Loopback-Schnittstelle bereitstellen, sodass lokale MCP-Clients Windows-Funktionen ohne laufendes OpenClaw-Gateway steuern können.

Aktivieren Sie ihn in den Windows-Hub-Einstellungen im Entwickler-/erweiterten Bereich. Die Anwendung 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 terminalorientierte 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-Aufgabenplanung, sofern verfügbar. Die Aufgabe behält das lesbare gateway.cmd-Skript im OpenClaw-Zustandsverzeichnis bei, startet es jedoch über einen generierten gateway.vbs-WScript-Wrapper, damit das im Hintergrund ausgeführte Gateway kein sichtbares Konsolenfenster öffnet. Wenn die Aufgabenerstellung verweigert wird, verwendet OpenClaw ersatzweise ein benutzerspezifisches Anmeldeelement im Autostartordner.

Installieren Sie den Gateway-Dienst:

openclaw gateway installopenclaw gateway status --json

Für eine reine CLI-Nutzung ohne verwalteten Gateway-Dienst:

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

WSL2-Gateway

WSL2 bleibt die am stärksten Linux-kompatible Gateway-Laufzeitumgebung unter Windows. Windows Hub kann ein anwendungseigenes WSL-Gateway für Sie einrichten; alternativ können Sie es manuell in Ihrer eigenen Distribution installieren.

Manuelle Einrichtung:

wsl --install# Oder ausdrücklich eine Distribution auswählen: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 mithilfe 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, auch 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 die Weiterleitungsregel bei Bedarf.

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, z. B. 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 den LAN-Zugriff und 127.0.0.1 für ausschließlich lokalen Zugriff.

Fehlerbehebung

Das Symbol im Infobereich 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 Symbole im Infobereich und heften Sie das Symbol an. Starten Sie andernfalls OpenClaw Companion über das Startmenü.

Die lokale Einrichtung schlägt fehl

Öffnen Sie das Einrichtungsprotokoll in Windows Hub oder prüfen Sie:

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

Häufige Ursachen: deaktiviertes WSL, blockierte Virtualisierung, veralteter anwendungseigener WSL- Zustand oder ein Netzwerkfehler bei der Installation des Gateway-Pakets.

Die Anwendung 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, Bildschirmaufzeichnung und Benachrichtigungen. Paketierte Installationen deklarieren die geschützten Funktionen, Windows kann jedoch weiterhin bei der ersten Verwendung durch einen Befehl nachfragen.

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 mit einem anderen Netzwerk, einem VPN oder einem HTTP-/HTTPS-Proxy.

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

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

Committen Sie niemals Token und fügen Sie sie nicht in Issues oder Pull Requests ein.

Verwandte Themen

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