Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw ondersteunt zowel native Windows als WSL2. WSL2 is de stabielere route en wordt aanbevolen voor de volledige ervaring: de CLI, Gateway en tooling draaien binnen Linux met volledige compatibiliteit. Native Windows werkt voor basisgebruik van de CLI en Gateway, met enkele kanttekeningen hieronder. Native Windows-companion-apps zijn gepland.

​
WSL2 (aanbevolen)

​
Status van native Windows

CLI-flows op native Windows worden beter, maar WSL2 blijft de aanbevolen route. Wat vandaag goed werkt op native Windows:
  • website-installatieprogramma via install.ps1
  • lokaal CLI-gebruik zoals openclaw --version, openclaw doctor en openclaw plugins list --json
  • ingebouwde rooktests voor lokale agent/provider zoals:
openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOWS-HATCH-OK."
Huidige kanttekeningen:
  • openclaw onboard --non-interactive verwacht nog steeds een bereikbare lokale gateway, tenzij je --skip-health meegeeft
  • openclaw onboard --non-interactive --install-daemon en openclaw gateway install proberen eerst Windows Scheduled Tasks
  • als het aanmaken van een Scheduled Task wordt geweigerd, valt OpenClaw terug op een login-item in de Startup-map per gebruiker en start het de gateway direct
  • als schtasks zelf vastloopt of niet meer reageert, breekt OpenClaw dat pad nu snel af en valt het terug in plaats van voor altijd te blijven hangen
  • Scheduled Tasks hebben nog steeds de voorkeur wanneer ze beschikbaar zijn, omdat ze betere supervisorstatus bieden
Als je alleen de native CLI wilt, zonder installatie van de gateway-service, gebruik dan een van deze: 
openclaw onboard --non-interactive --skip-health
openclaw gateway run
Als je wel beheerde opstart op native Windows wilt: 
openclaw gateway install
openclaw gateway status --json
Als het aanmaken van Scheduled Tasks wordt geblokkeerd, start de fallback-servicemodus nog steeds automatisch na aanmelding via de Startup-map van de huidige gebruiker.

​
Gateway

​
Gateway-service installeren (CLI)

Binnen WSL2: 
openclaw onboard --install-daemon
Of: 
openclaw gateway install
Of: 
openclaw configure
Selecteer Gateway-service wanneer daarom wordt gevraagd. Herstellen/migreren: 
openclaw doctor

​
Gateway automatisch starten vóór Windows-aanmelding

Zorg er voor headless setups voor dat de volledige opstartketen draait, zelfs wanneer niemand zich aanmeldt bij Windows.

​
1) Gebruikersservices laten draaien zonder aanmelding

Binnen WSL: 
sudo loginctl enable-linger "$(whoami)"

​
2) De OpenClaw Gateway-gebruikersservice installeren

Binnen WSL: 
openclaw gateway install

​
3) WSL automatisch starten bij het opstarten van Windows

In PowerShell als Administrator: 
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM
Vervang Ubuntu door je distronaam uit: 
wsl --list --verbose

​
Opstartketen verifiëren

Controleer na een herstart (vóór Windows-aanmelding) vanuit WSL: 
systemctl --user is-enabled openclaw-gateway.service
systemctl --user status openclaw-gateway.service --no-pager

​
Geavanceerd: WSL-services via LAN beschikbaar maken (portproxy)

WSL heeft een eigen virtueel netwerk. Als een andere machine een service moet bereiken die binnen WSL draait (SSH, een lokale TTS-server of de Gateway), moet je een Windows-poort doorsturen naar het huidige WSL-IP. Het WSL-IP verandert na herstarts, dus mogelijk moet je de doorstuurregel vernieuwen. Voorbeeld (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 not found." }

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
  connectaddress=$WslIp connectport=$TargetPort
Sta de poort toe via Windows Firewall (eenmalig): 
New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow
Vernieuw de portproxy nadat WSL opnieuw is gestart: 
netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 | Out-Null
netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
  connectaddress=$WslIp connectport=$TargetPort | Out-Null
Opmerkingen:
  • SSH vanaf een andere machine richt zich op het Windows-host-IP (voorbeeld: ssh user@windows-host -p 2222).
  • Remote nodes moeten naar een bereikbare Gateway-URL verwijzen (niet 127.0.0.1); gebruik openclaw status --all om dit te bevestigen.
  • Gebruik listenaddress=0.0.0.0 voor LAN-toegang; 127.0.0.1 houdt het alleen lokaal.
  • Als je dit automatisch wilt, registreer dan een Scheduled Task om de vernieuwingsstap bij aanmelding uit te voeren.

​
Stapsgewijze WSL2-installatie

​
1) WSL2 + Ubuntu installeren

Open PowerShell (Admin): 
wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04
Herstart als Windows daarom vraagt.

​
2) systemd inschakelen (vereist voor gateway-installatie)

In je WSL-terminal: 
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
Daarna vanuit PowerShell: 
wsl --shutdown
Open Ubuntu opnieuw en verifieer daarna: 
systemctl --user status

​
3) OpenClaw installeren (binnen WSL)

Volg voor een normale eerste setup binnen WSL de Linux-flow Aan de slag: 
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm ui:build
pnpm openclaw onboard --install-daemon
Als je vanuit de broncode ontwikkelt in plaats van een eerste onboarding uit te voeren, gebruik dan de source-dev-loop uit Setup: 
pnpm install
# First run only (or after resetting local OpenClaw config/workspace)
pnpm openclaw setup
pnpm gateway:watch
Volledige handleiding: Aan de slag

​
Windows-companion-app

We hebben nog geen Windows-companion-app. Bijdragen zijn welkom als je wilt helpen om dit mogelijk te maken.

​
Git- en GitHub-connectiviteit (contributors)

Sommige netwerken blokkeren of beperken HTTPS naar GitHub. Als git clone mislukt met time-outs of verbindingsresets, probeer dan een ander netwerk, een VPN of een HTTP/HTTPS-proxy die je organisatie aanbiedt. Als gh auth login mislukt tijdens de browser-device-flow (bijvoorbeeld een time-out bij het bereiken van github.com:443), authenticeer dan in plaats daarvan met een persoonlijk toegangstoken:
  1. Maak een token met ten minste de repo-scope (classic PAT) of equivalente fijnmazige toegang.
  2. In PowerShell voor de huidige sessie:
$env:GH_TOKEN="<your-token>"
gh auth status
gh auth setup-git
  1. Als gh auth status waarschuwt voor ontbrekende read:org, maak dan een token aan dat die scope bevat en wijs de variabele opnieuw toe:
$env:GH_TOKEN="<your-token-with-repo-and-read:org>"
gh auth status
gh auth refresh -s read:org is alleen van toepassing wanneer je via gh auth login bent geauthenticeerd en opgeslagen credentials hebt om te vernieuwen (niet wanneer je GH_TOKEN gebruikt). Commit nooit tokens en plak ze niet in issues of pull requests.

​
Gerelateerd