Windows

OpenClaw wordt geleverd met een native begeleidende Windows Hub-app plus CLI-ondersteuning voor Windows. Gebruik Windows Hub voor een desktop-app met configuratie, systeemvakstatus, chat, diagnostiek in het Opdrachtcentrum en Windows-mogelijkheden voor Nodes. Gebruik het PowerShell- installatieprogramma rechtstreeks voor de CLI/Gateway. Gebruik WSL2 voor de meest Linux-compatibele Gateway-runtime.

Aanbevolen: Windows Hub

Windows Hub is de native WinUI-begeleidende app voor Windows 10 20H2+ en Windows 11. De app wordt zonder beheerdersrechten geïnstalleerd en biedt ondertekende x64- en ARM64-installatieprogramma’s via een eigen releasepagina. Windows Hub wordt onafhankelijk van de OpenClaw-CLI en Gateway uitgebracht. Download het nieuwste stabiele Hub-installatieprogramma vanaf de releasepagina van Windows Hub of rechtstreeks via releases/latest/download:

Als een bovenstaande link een 404-fout geeft, ga je naar de releasepagina van Windows Hub en open je de nieuwste stabiele Windows Hub-release. Reguliere stabiele OpenClaw-releases spiegelen ook een vastgezette, voor de release gevalideerde Windows Hub-build; die spiegel kan achterlopen op een nieuwere zelfstandige Hub-release. Start na de installatie OpenClaw Companion via het Startmenu of het systeemvak. Het installatieprogramma voegt ook snelkoppelingen toe voor Gateway-configuratie, Chat, Instellingen, Controleren op updates en verwijderen.

Wat Windows Hub bevat

Systeemvakstatus en starten bij aanmelden.
Configuratie bij de eerste start voor een lokale, door de app beheerde WSL-Gateway.
Verbindingsinstellingen voor lokale en externe Gateways en Gateways via een SSH-tunnel.
Native chatvenster plus toegang tot de browsergebaseerde bedieningsinterface.
Diagnostiek in het Opdrachtcentrum voor sessies, gebruik, kanalen, Nodes, koppeling en herstelopdrachten.
Windows-Node-modus voor door de agent bestuurd canvas, scherm, camera, meldingen, apparaatstatus, spraak en beheerste system.run.
Lokale MCP-servermodus voor MCP-clients zoals Claude Desktop, Claude Code en Cursor.

Eerste start

Bij de eerste start opent Windows Hub de configuratie als er geen bruikbare opgeslagen Gateway is. De snelste route is Lokaal configureren. Hiermee wordt een door de app beheerde OpenClawGateway WSL-distributie ingericht, de Gateway daarin geïnstalleerd en de app gekoppeld. Je bestaande Ubuntu-distributie wordt hierbij niet geëxporteerd of gewijzigd. Kies Geavanceerde configuratie of open het tabblad Verbindingen als je al een Gateway hebt. Je kunt verbinding maken met:

een lokale Gateway op deze pc
een WSL-Gateway op deze pc
een externe Gateway via een URL en token of configuratiecode
een Gateway die via een SSH-tunnel bereikbaar is

Wanneer de configuratie is voltooid, wordt het systeemvakpictogram groen. Open Opdrachtcentrum vanuit het systeemvak om de verbinding, koppeling, Node-status en kanaalstatus te controleren.

Windows-Node-modus

Windows Hub kan zich registreren als een OpenClaw-Node, zodat de agent aangegeven native Windows-mogelijkheden via de Gateway kan gebruiken. Node-opdrachten moeten door de Node zijn aangegeven en door het Gateway-beleid zijn toegestaan voordat ze worden uitgevoerd; zie Nodes voor het volledige model voor toestaan en weigeren. Veelgebruikte opdrachten:

Familie	Opdrachten
Canvas	`canvas.present`, `canvas.hide`, `canvas.navigate`, `canvas.eval`, `canvas.snapshot`
Scherm	`screen.snapshot`; `screen.record` vereist expliciete inschakeling
Camera	`camera.list`; `camera.snap`, `camera.clip` vereisen expliciete inschakeling
Systeem	`system.notify`, `system.run`, `system.run.prepare`, `system.which`
Apparaat	`location.get`, `device.info`, `device.status`
Spraak	`talk.ptt.start`, `talk.ptt.stop`, `talk.ptt.cancel`, `talk.ptt.once`, `talk.speak`

De Node-modus vereist koppeling met de Gateway. Als de app een koppelingsverzoek toont, keur je dit goed vanaf de Gateway-host:

openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status

De Gateway stuurt alleen opdrachten door die de Node aangeeft en die door het serverbeleid zijn toegestaan. Privacygevoelige opdrachten zoals screen.record, camera.snap en camera.clip vereisen expliciete inschakeling via gateway.nodes.commands.allow.

Lokale MCP-modus

Windows Hub kan hetzelfde register met native Windows-mogelijkheden beschikbaar stellen als een lokale MCP-server op de loopbackinterface, zodat lokale MCP-clients Windows-mogelijkheden kunnen aansturen zonder een actieve OpenClaw-Gateway. Schakel dit in via de ontwikkelaars-/geavanceerde sectie in de instellingen van Windows Hub. De app toont het loopback-eindpunt en bearer-token zodra de server is ingeschakeld. Modusmatrix:

Node-modus	MCP-server	Gedrag
uit	uit	Desktop-app alleen voor de operator
aan	uit	Met Gateway verbonden Windows-Node
uit	aan	Alleen lokale MCP-server
aan	aan	Gateway-Node plus lokale MCP-server

Native Windows-CLI en Gateway

Installeer OpenClaw vanuit PowerShell voor gebruik dat primair op de terminal is gericht:

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

Controleer:

openclaw --version
openclaw doctor
openclaw gateway status --json

Beheerd opstarten gebruikt waar mogelijk Geplande taken van Windows. De taak bewaart het leesbare gateway.cmd-script in de OpenClaw-statusmap, maar start het via een gegenereerde gateway.vbs WScript-wrapper, zodat de Gateway op de achtergrond geen zichtbaar consolevenster opent. Als het maken van de taak wordt geweigerd, valt OpenClaw terug op een aanmeldingsitem per gebruiker in de map Opstarten. Installeer de Gateway-service:

openclaw gateway install
openclaw gateway status --json

Voor uitsluitend CLI-gebruik zonder een beheerde Gateway-service:

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

WSL2-Gateway

WSL2 blijft de meest Linux-compatibele Gateway-runtime op Windows. Windows Hub kan een door de app beheerde WSL-Gateway voor je configureren, of je kunt deze handmatig in je eigen distributie installeren. Handmatige configuratie:

wsl --install
# Of kies expliciet een distributie:
wsl --list --online
wsl --install -d Ubuntu-24.04

Schakel systemd in WSL in:

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

Start WSL opnieuw vanuit PowerShell:

wsl --shutdown

Installeer vervolgens OpenClaw in WSL met de Linux-snelstart:

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

Gateway automatisch starten vóór aanmelden bij Windows

Zorg er bij headless WSL-configuraties voor dat de volledige opstartketen wordt uitgevoerd, zelfs als niemand zich bij Windows aanmeldt. Binnen WSL:

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

In PowerShell als beheerder:

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

Vervang Ubuntu door de naam van je distributie uit:

wsl --list --verbose

Twee wijzigingen ten opzichte van oudere instructies:

dbus-launch true in plaats van /bin/true: in WSL >= 2.6.1.0 zorgt een regressie (microsoft/WSL #13416) ervoor dat de distributie wegens inactiviteit 15-20 seconden nadat de laatste client is afgesloten wordt beëindigd, zelfs als linger is ingeschakeld. dbus-launch true houdt als tijdelijke oplossing een onderliggend proces van init actief (communitydiscussie, microsoft/WSL #9245).
/ru "$env:USERNAME" in plaats van /ru SYSTEM: WSL-distributies per gebruiker (de standaardconfiguratie) zijn niet zichtbaar voor het SYSTEM-account. Daardoor lijkt de taak te worden uitgevoerd, maar start de distributie nooit. Dit wordt voorkomen door de taak onder je eigen account uit te voeren; Windows vraagt om je wachtwoord wanneer de taak wordt gemaakt.

Controleer na het opnieuw opstarten vanuit WSL:

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

WSL-services beschikbaar stellen via het LAN

WSL heeft een eigen virtueel netwerk. Als een andere machine een service binnen WSL moet kunnen bereiken, stuur je een Windows-poort door naar het huidige WSL-IP-adres. Het WSL-IP-adres kan na opnieuw opstarten veranderen. Werk de doorstuurregel daarom indien nodig bij. Voorbeeld in PowerShell als beheerder:

$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22

$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "WSL-IP-adres niet gevonden." }

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

Opmerkingen:

SSH vanaf een andere machine gebruikt het IP-adres van de Windows-host, bijvoorbeeld ssh user@windows-host -p 2222.
Externe Nodes moeten naar een bereikbare Gateway-URL verwijzen, niet naar 127.0.0.1.
Gebruik listenaddress=0.0.0.0 voor LAN-toegang en 127.0.0.1 voor uitsluitend lokale toegang.

Probleemoplossing

Het systeemvakpictogram verschijnt niet

Controleer Taakbeheer op OpenClaw.Tray.WinUI.exe. Als dit actief is, open je het gebied met verborgen systeemvakpictogrammen en maak je het pictogram vast. Als het niet actief is, start je OpenClaw Companion vanuit het Startmenu.

Lokale configuratie mislukt

Open het configuratielogboek vanuit Windows Hub of bekijk:

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

Veelvoorkomende oorzaken: uitgeschakelde WSL, geblokkeerde virtualisatie, verouderde door de app beheerde WSL- status of een netwerkfout tijdens de installatie van het Gateway-pakket.

De app meldt dat koppeling vereist is

Keur het operator- of Node-verzoek goed vanaf de Gateway:

openclaw devices list
openclaw devices approve <requestId>

Als het apparaat al een token had, maak je na goedkeuring opnieuw verbinding via het tabblad Verbindingen.

Webchat kan een externe Gateway niet bereiken

Externe webchat vereist HTTPS of localhost. Vertrouw bij zelfondertekende certificaten het certificaat in Windows, of gebruik een SSH-tunnel naar een localhost-URL.

`screen.snapshot`-, camera- of audio-opdrachten mislukken

Controleer de Windows-machtigingen voor camera, microfoon, schermopname en meldingen. Verpakte installaties geven de beschermde mogelijkheden aan, maar Windows kan nog steeds om toestemming vragen wanneer een opdracht deze voor het eerst gebruikt.

Verbinding met Git of GitHub mislukt

Sommige netwerken blokkeren of beperken HTTPS-verkeer naar GitHub. Als git clone of gh auth login mislukt, probeer je een ander netwerk, een VPN of een HTTP/HTTPS-proxy. Voor tokengebaseerde gh-authenticatie in de huidige sessie:

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

Commit tokens nooit en plak ze niet in issues of pull requests.

Platforms overview

macOS companion app

Aanbevolen: Windows Hub

Wat Windows Hub bevat

Eerste start

Windows-Node-modus

Lokale MCP-modus

Native Windows-CLI en Gateway

WSL2-Gateway

Gateway automatisch starten vóór aanmelden bij Windows

WSL-services beschikbaar stellen via het LAN

Probleemoplossing

Het systeemvakpictogram verschijnt niet

Lokale configuratie mislukt

De app meldt dat koppeling vereist is

Webchat kan een externe Gateway niet bereiken

`screen.snapshot`-, camera- of audio-opdrachten mislukken

Verbinding met Git of GitHub mislukt

Gerelateerd

​Aanbevolen: Windows Hub

​Wat Windows Hub bevat

​Eerste start

​Windows-Node-modus

​Lokale MCP-modus

​Native Windows-CLI en Gateway

​WSL2-Gateway

​Gateway automatisch starten vóór aanmelden bij Windows

​WSL-services beschikbaar stellen via het LAN

​Probleemoplossing

​Het systeemvakpictogram verschijnt niet

​Lokale configuratie mislukt

​De app meldt dat koppeling vereist is

​Webchat kan een externe Gateway niet bereiken

​screen.snapshot-, camera- of audio-opdrachten mislukken

​Verbinding met Git of GitHub mislukt

​Gerelateerd

Aanbevolen: Windows Hub

Wat Windows Hub bevat

Eerste start

Windows-Node-modus

Lokale MCP-modus

Native Windows-CLI en Gateway

WSL2-Gateway

Gateway automatisch starten vóór aanmelden bij Windows

WSL-services beschikbaar stellen via het LAN

Probleemoplossing

Het systeemvakpictogram verschijnt niet

Lokale configuratie mislukt

De app meldt dat koppeling vereist is

Webchat kan een externe Gateway niet bereiken

`screen.snapshot`-, camera- of audio-opdrachten mislukken

Verbinding met Git of GitHub mislukt

Gerelateerd