> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Windows (WSL2)

# Windows (WSL2)

OpenClaw på Windows rekommenderas **via WSL2** (Ubuntu rekommenderas).
CLI + Gateway körs inuti Linux, vilket håller körtiden konsekvent och gör
verktyg betydligt mer kompatibla (Node/Bun/pnpm, Linux-binärer, färdigheter). Inhemska
Windows kan vara knepigare. WSL2 ger dig den fullständiga Linuxupplevelsen — ett kommando
för att installera: `wsl --install`.

Native Windows companion-appar är planerade.

## Installera (WSL2)

* [Kom igång](/start/getting-started) (använd inuti WSL)
* [Installera & uppdateringar](/install/updating)
* Officiell WSL2-guide (Microsoft): [https://learn.microsoft.com/windows/wsl/install](https://learn.microsoft.com/windows/wsl/install)

## Gateway

* [Gateway-runbook](/gateway)
* [Konfiguration](/gateway/configuration)

## Installera Gateway-tjänst (CLI)

Inuti WSL2:

```
openclaw onboard --install-daemon
```

Eller:

```
openclaw gateway install
```

Eller:

```
openclaw configure
```

Välj **Gateway service** när du blir tillfrågad.

Reparera/migrera:

```
openclaw doctor
```

## Avancerat: exponera WSL-tjänster över LAN (portproxy)

WSL har ett eget virtuellt nätverk. Om en annan maskin behöver nå en tjänst
som kör **inuti WSL** (SSH, en lokal TTS-server, eller Gateway), du måste
vidarebefordra en Windows-port till den nuvarande WSL IP. WSL IP ändringarna efter omstarten,
så du kan behöva uppdatera vidarebefordringsregeln.

Exempel (PowerShell **som administratör**):

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
$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
```

Tillåt porten genom Windows-brandväggen (engångs):

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow
```

Uppdatera portproxy efter att WSL startats om:

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```

Noteringar:

* SSH från en annan maskin riktar sig mot **Windows-värdens IP** (exempel: `ssh user@windows-host -p 2222`).
* Fjärrnoder måste peka på en **nåbar** Gateway-URL (inte `127.0.0.1`); använd
  `openclaw status --all` för att bekräfta.
* Använd `listenaddress=0.0.0.0` för LAN-åtkomst; `127.0.0.1` håller det endast lokalt.
* Om du vill ha detta automatiskt, registrera en schemalagd aktivitet som kör
  uppdateringssteget vid inloggning.

## Steg-för-steg WSL2-installation

### 1. Installera WSL2 + Ubuntu

Öppna PowerShell (Admin):

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04
```

Starta om om Windows ber om det.

### 2. Aktivera systemd (krävs för Gateway-installation)

I din WSL-terminal:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
```

Sedan från PowerShell:

```powershell theme={"theme":{"light":"min-light","dark":"min-dark"}}
wsl --shutdown
```

Öppna Ubuntu igen och verifiera:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
systemctl --user status
```

### 3. Installera OpenClaw (inuti WSL)

Följ Linux-flödet för Kom igång inuti WSL:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # auto-installs UI deps on first run
pnpm build
openclaw onboard
```

Fullständig guide: [Kom igång](/start/getting-started)

## Windows companion-app

Vi har inte en Windows följeslagare app än. Bidrag är välkomna om du vill att
bidrag ska få det att hända.