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:

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:

Familie	Befehle
Canvas	`canvas.present`, `canvas.hide`, `canvas.navigate`, `canvas.eval`, `canvas.snapshot`
Bildschirm	`screen.snapshot`; `screen.record` erfordert eine ausdrückliche Aktivierung
Kamera	`camera.list`; `camera.snap`, `camera.clip` erfordern eine ausdrückliche Aktivierung
System	`system.notify`, `system.run`, `system.run.prepare`, `system.which`
Gerät	`location.get`, `device.info`, `device.status`
Sprachausgabe	`talk.ptt.start`, `talk.ptt.stop`, `talk.ptt.cancel`, `talk.ptt.once`, `talk.speak`

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

openclaw devices list
openclaw 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:

Node-Modus	MCP-Server	Verhalten
aus	aus	Desktopanwendung nur für Bedienende
ein	aus	Mit dem Gateway verbundener Windows-Node
aus	ein	Nur lokaler MCP-Server
ein	ein	Gateway-Node plus lokaler MCP-Server

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 --version
openclaw doctor
openclaw 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 install
openclaw gateway status --json

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

openclaw onboard --non-interactive --skip-health
openclaw 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 --online
wsl --install -d Ubuntu-24.04

Aktivieren Sie systemd innerhalb von WSL:

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

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 | bash
openclaw 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-x11
sudo 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

Zwei Änderungen gegenüber älteren Anleitungen:

dbus-launch true anstelle von /bin/true: Unter WSL >= 2.6.1.0 beendet eine Regression (microsoft/WSL #13416) die inaktive Distribution 15–20 Sekunden, nachdem der letzte Client beendet wurde, selbst bei aktivierter Benutzerpersistenz. dbus-launch true hält als Umgehung einen untergeordneten Prozess von init aktiv (Community-Diskussion, microsoft/WSL #9245).
/ru "$env:USERNAME" anstelle von /ru SYSTEM: Benutzerspezifische WSL-Distributionen (die Standardeinrichtung) sind für das SYSTEM-Konto nicht sichtbar. Daher scheint die Aufgabe ausgeführt zu werden, die Distribution wird jedoch nie gestartet. Durch die Ausführung unter Ihrem eigenen Konto wird dies vermieden; Windows fordert bei der Erstellung der Aufgabe Ihr Passwort an.

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

systemctl --user is-enabled openclaw-gateway.service
systemctl --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 list
openclaw 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 status
gh auth setup-git

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

Platforms overview

macOS companion app

Empfohlen: Windows Hub

Inhalt von Windows Hub

Erster Start

Windows-Node-Modus

Lokaler MCP-Modus

Native Windows-CLI und Gateway

WSL2-Gateway

Automatischer Gateway-Start vor der Windows-Anmeldung

WSL-Dienste im LAN bereitstellen

Fehlerbehebung

Das Symbol im Infobereich wird nicht angezeigt

Die lokale Einrichtung schlägt fehl

Die Anwendung meldet, dass eine Kopplung erforderlich ist

Der Webchat kann ein entferntes Gateway nicht erreichen

`screen.snapshot`-, Kamera- oder Audiobefehle schlagen fehl

Git- oder GitHub-Verbindungen schlagen fehl

Verwandte Themen

​Empfohlen: Windows Hub

​Inhalt von Windows Hub

​Erster Start

​Windows-Node-Modus

​Lokaler MCP-Modus

​Native Windows-CLI und Gateway

​WSL2-Gateway

​Automatischer Gateway-Start vor der Windows-Anmeldung

​WSL-Dienste im LAN bereitstellen

​Fehlerbehebung

​Das Symbol im Infobereich wird nicht angezeigt

​Die lokale Einrichtung schlägt fehl

​Die Anwendung meldet, dass eine Kopplung erforderlich ist

​Der Webchat kann ein entferntes Gateway nicht erreichen

​screen.snapshot-, Kamera- oder Audiobefehle schlagen fehl

​Git- oder GitHub-Verbindungen schlagen fehl

​Verwandte Themen

Empfohlen: Windows Hub

Inhalt von Windows Hub

Erster Start

Windows-Node-Modus

Lokaler MCP-Modus

Native Windows-CLI und Gateway

WSL2-Gateway

Automatischer Gateway-Start vor der Windows-Anmeldung

WSL-Dienste im LAN bereitstellen

Fehlerbehebung

Das Symbol im Infobereich wird nicht angezeigt

Die lokale Einrichtung schlägt fehl

Die Anwendung meldet, dass eine Kopplung erforderlich ist

Der Webchat kann ein entferntes Gateway nicht erreichen

`screen.snapshot`-, Kamera- oder Audiobefehle schlagen fehl

Git- oder GitHub-Verbindungen schlagen fehl

Verwandte Themen