Windows (WSL2)

Использование OpenClaw в Windows рекомендуется через WSL2 (рекомендуется Ubuntu). CLI + Gateway работают внутри Linux, что обеспечивает единообразие среды выполнения и делает инструменты значительно более совместимыми (Node/Bun/pnpm, бинарники Linux, skills). Нативная Windows-среда может быть более сложной. WSL2 даёт полноценный опыт Linux — установка одной командой: wsl --install. Нативные сопутствующие приложения для Windows планируются.

Установка (WSL2)

Начало работы (используйте внутри WSL)
Установка и обновления
Официальное руководство по WSL2 (Microsoft): https://learn.microsoft.com/windows/wsl/install

Gateway

Установка сервиса Gateway (CLI)

Внутри WSL2:

openclaw onboard --install-daemon

Или:

openclaw gateway install

Или:

openclaw configure

При запросе выберите Gateway service. Восстановление/миграция:

openclaw doctor

Дополнительно: публикация сервисов WSL в LAN (portproxy)

WSL имеет собственную виртуальную сеть. Если другой машине нужно получить доступ к сервису, запущенному внутри WSL (SSH, локальный TTS‑сервер или Gateway), необходимо пробросить порт Windows на текущий IP WSL. IP WSL меняется после перезапусков, поэтому правило проброса может потребоваться обновлять. Пример (PowerShell от имени администратора):

$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

Разрешите порт в брандмауэре Windows (один раз):

New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow

Обновляйте portproxy после перезапуска WSL:

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

Примечания:

SSH с другой машины нацелен на IP хоста Windows (пример: ssh user@windows-host -p 2222).
Удалённые узлы должны указывать доступный URL Gateway (не 127.0.0.1); используйте openclaw status --all для проверки.
Используйте listenaddress=0.0.0.0 для доступа из LAN; 127.0.0.1 оставляет доступ только локальным.
Если требуется автоматизация, зарегистрируйте задачу Планировщика для выполнения шага обновления при входе в систему.

Пошаговая установка WSL2

1. Установите WSL2 + Ubuntu

Откройте PowerShell (Администратор):

wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04

Перезагрузитесь, если Windows запросит.

2. Включите systemd (требуется для установки Gateway)

В терминале WSL:

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

Затем из PowerShell:

wsl --shutdown

Снова откройте Ubuntu и проверьте:

systemctl --user status

3. Установите OpenClaw (внутри WSL)

Следуйте процессу «Начало работы» для Linux внутри WSL:

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

Полное руководство: Начало работы

Сопутствующее приложение для Windows

В настоящее время сопутствующего приложения для Windows нет. Мы приветствуем вклад сообщества, если вы хотите помочь сделать его реальностью.

Обзор платформ

Сопутствующее приложение для macOS

Windows (WSL2)

Windows (WSL2)

Установка (WSL2)

Gateway

Установка сервиса Gateway (CLI)

Дополнительно: публикация сервисов WSL в LAN (portproxy)

Пошаговая установка WSL2

1. Установите WSL2 + Ubuntu

2. Включите systemd (требуется для установки Gateway)

3. Установите OpenClaw (внутри WSL)

Сопутствующее приложение для Windows

​Windows (WSL2)

​Установка (WSL2)

​Gateway

​Установка сервиса Gateway (CLI)

​Дополнительно: публикация сервисов WSL в LAN (portproxy)

​Пошаговая установка WSL2

​1. Установите WSL2 + Ubuntu

​2. Включите systemd (требуется для установки Gateway)

​3. Установите OpenClaw (внутри WSL)

​Сопутствующее приложение для Windows

Windows (WSL2)

Установка (WSL2)

Gateway

Установка сервиса Gateway (CLI)

Дополнительно: публикация сервисов WSL в LAN (portproxy)

Пошаговая установка WSL2

1. Установите WSL2 + Ubuntu

2. Включите systemd (требуется для установки Gateway)

3. Установите OpenClaw (внутри WSL)

Сопутствующее приложение для Windows