--- read_when: - Встановлення OpenClaw у Windows - Вибір між нативною Windows і WSL2 - Пошук статусу супутнього застосунку для Windows summary: 'Підтримка Windows: нативний шлях встановлення та шлях встановлення через WSL2, демон і поточні застереження' title: Windows x-i18n: generated_at: "2026-05-05T05:35:38Z" model: gpt-5.5 provider: openai source_hash: adf885747e3a897cb4ee57f6494805468d38c4595c0ab7582b063153a1134d18 source_path: platforms/windows.md workflow: 16 --- OpenClaw підтримує як **нативний Windows**, так і **WSL2**. WSL2 є стабільнішим шляхом і рекомендований для повного досвіду — CLI, Gateway і інструменти працюють усередині Linux із повною сумісністю. Нативний Windows підходить для базового використання CLI та Gateway, з деякими застереженнями, зазначеними нижче. Супутні застосунки для нативного Windows заплановані. ## WSL2 (рекомендовано) - [Початок роботи](/uk/start/getting-started) (використовуйте всередині WSL) - [Встановлення та оновлення](/uk/install/updating) - Офіційний посібник WSL2 (Microsoft): [https://learn.microsoft.com/windows/wsl/install](https://learn.microsoft.com/windows/wsl/install) ## Стан нативного Windows Потоки CLI для нативного Windows покращуються, але WSL2 досі є рекомендованим шляхом. Що добре працює на нативному Windows сьогодні: - встановлювач із вебсайту через `install.ps1` - локальне використання CLI, як-от `openclaw --version`, `openclaw doctor` і `openclaw plugins list --json` - вбудована димова перевірка локального агента/провайдера, наприклад: ```powershell openclaw agent --local --agent main --thinking low -m "Reply with exactly WINDOWS-HATCH-OK." ``` Поточні застереження: - `openclaw onboard --non-interactive` досі очікує доступний локальний Gateway, якщо не передати `--skip-health` - `openclaw onboard --non-interactive --install-daemon` і `openclaw gateway install` спершу пробують Windows Scheduled Tasks - якщо створення Scheduled Task заборонено, OpenClaw повертається до елемента входу в папці автозапуску поточного користувача та одразу запускає Gateway - якщо сам `schtasks` зависає або перестає відповідати, OpenClaw тепер швидко перериває цей шлях і переходить до резервного варіанту, замість того щоб зависати назавжди - Scheduled Tasks досі бажані, коли доступні, бо вони надають кращий статус супервізора Якщо вам потрібен лише нативний CLI, без встановлення служби Gateway, використайте один із цих варіантів: ```powershell openclaw onboard --non-interactive --skip-health openclaw gateway run ``` Якщо ви хочете керований автозапуск у нативному Windows: ```powershell openclaw gateway install openclaw gateway status --json ``` Якщо створення Scheduled Task заблоковано, резервний режим служби все одно автоматично запускається після входу через папку автозапуску поточного користувача. ## Gateway - [Операційний посібник Gateway](/uk/gateway) - [Конфігурація](/uk/gateway/configuration) ## Встановлення служби Gateway (CLI) Усередині WSL2: ``` openclaw onboard --install-daemon ``` Або: ``` openclaw gateway install ``` Або: ``` openclaw configure ``` Виберіть **службу Gateway**, коли з’явиться запит. Відновлення/міграція: ``` openclaw doctor ``` ## Автозапуск Gateway до входу в Windows Для безголових налаштувань переконайтеся, що повний ланцюг завантаження працює навіть тоді, коли ніхто не входить у Windows. ### 1) Підтримуйте роботу користувацьких служб без входу Усередині WSL: ```bash sudo loginctl enable-linger "$(whoami)" ``` ### 2) Встановіть користувацьку службу OpenClaw gateway Усередині WSL: ```bash openclaw gateway install ``` ### 3) Автоматично запускайте WSL під час завантаження Windows У PowerShell від імені адміністратора: ```powershell schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM ``` Замініть `Ubuntu` на назву вашого дистрибутива з: ```powershell wsl --list --verbose ``` ### Перевірте ланцюг запуску Після перезавантаження (до входу в Windows) перевірте з WSL: ```bash systemctl --user is-enabled openclaw-gateway.service systemctl --user status openclaw-gateway.service --no-pager ``` ## Додатково: відкриття служб WSL у LAN (portproxy) WSL має власну віртуальну мережу. Якщо іншій машині потрібно дістатися до служби, що працює **всередині WSL** (SSH, локальний TTS-сервер або Gateway), потрібно перенаправити порт Windows на поточну IP-адресу WSL. IP-адреса WSL змінюється після перезапусків, тому може знадобитися оновити правило перенаправлення. Приклад (PowerShell **від імені адміністратора**): ```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 Firewall (одноразово): ```powershell New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound ` -Protocol TCP -LocalPort $ListenPort -Action Allow ``` Оновіть portproxy після перезапуску WSL: ```powershell 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` залишає його лише локальним. - Якщо хочете автоматизувати це, зареєструйте Scheduled Task для запуску кроку оновлення під час входу. ## Покрокове встановлення WSL2 ### 1) Встановіть WSL2 + Ubuntu Відкрийте PowerShell (адміністратор): ```powershell wsl --install # Or pick a distro explicitly: wsl --list --online wsl --install -d Ubuntu-24.04 ``` Перезавантажтеся, якщо Windows попросить. ### 2) Увімкніть systemd (потрібно для встановлення Gateway) У вашому терміналі WSL: ```bash sudo tee /etc/wsl.conf >/dev/null <<'EOF' [boot] systemd=true EOF ``` Потім з PowerShell: ```powershell wsl --shutdown ``` Знову відкрийте Ubuntu, потім перевірте: ```bash systemctl --user status ``` ### 3) Встановіть OpenClaw (усередині WSL) Для звичайного першого налаштування всередині WSL дотримуйтеся Linux-потоку початку роботи: ```bash git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm build pnpm ui:build pnpm openclaw onboard --install-daemon ``` Якщо ви розробляєте з вихідного коду, а не виконуєте перше онбординг-налаштування, використовуйте цикл розробки з вихідного коду з [Налаштування](/uk/start/setup): ```bash pnpm install # First run only (or after resetting local OpenClaw config/workspace) pnpm openclaw setup pnpm gateway:watch ``` Повний посібник: [Початок роботи](/uk/start/getting-started) ## Супутній застосунок Windows У нас ще немає супутнього застосунку Windows. Внески вітаються, якщо ви хочете допомогти це реалізувати. ## Підключення Git і GitHub (контриб’ютори) Деякі мережі блокують або обмежують HTTPS до GitHub. Якщо `git clone` завершується невдало через тайм-аути або скидання з’єднання, спробуйте іншу мережу, VPN або HTTP/HTTPS-проксі, який надає ваша організація. Якщо `gh auth login` завершується невдало під час браузерного потоку пристрою (наприклад, тайм-аут підключення до `github.com:443`), автентифікуйтеся натомість за допомогою персонального токена доступу: 1. Створіть токен принаймні з областю `repo` (класичний PAT) або еквівалентним детальним доступом. 2. У PowerShell для поточного сеансу: ```powershell $env:GH_TOKEN="" gh auth status gh auth setup-git ``` 3. Якщо `gh auth status` попереджає про відсутній `read:org`, створіть токен, який включає цю область, і повторно призначте змінну: ```powershell $env:GH_TOKEN="" gh auth status ``` `gh auth refresh -s read:org` застосовується лише тоді, коли ви автентифікувалися через `gh auth login` і маєте збережені облікові дані для оновлення (не під час використання `GH_TOKEN`). Ніколи не комітьте токени й не вставляйте їх в issue або pull request. ## Пов’язане - [Огляд встановлення](/uk/install) - [Платформи](/uk/platforms)