OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Platforms overview

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:

powershell
openclaw devices listopenclaw 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:

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

Controleer:

powershell
openclaw --versionopenclaw doctoropenclaw 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:

powershell
openclaw gateway installopenclaw gateway status --json

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

powershell
openclaw onboard --non-interactive --skip-healthopenclaw 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:

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

Schakel systemd in WSL in:

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

Start WSL opnieuw vanuit PowerShell:

powershell
wsl --shutdown

Installeer vervolgens OpenClaw in WSL met de Linux-snelstart:

bash
curl -fsSL https://openclaw.ai/install.sh | bashopenclaw 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:

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

In PowerShell als beheerder:

powershell
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:

powershell
wsl --list --verbose

Controleer na het opnieuw opstarten vanuit WSL:

bash
systemctl --user is-enabled openclaw-gateway.servicesystemctl --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:

powershell
$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:

powershell
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:

powershell
openclaw devices listopenclaw 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:

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

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

Gerelateerd

Was this useful?
On this page

On this page