Перейти до основного вмісту
OpenClaw постачається з нативним супутнім застосунком Windows Hub і підтримкою Windows CLI. Використовуйте Windows Hub, коли потрібен настільний застосунок із налаштуванням, станом у треї, чатом, діагностикою Command Center і можливостями вузла Windows. Використовуйте інсталятор PowerShell, коли потрібні CLI/Gateway напряму. Використовуйте WSL2, коли потрібне найбільш сумісне з Linux середовище виконання Gateway.

​
Рекомендовано: Windows Hub

Windows Hub — це нативний супутній застосунок WinUI для Windows 10 20H2+ і Windows 11. Він установлюється без прав адміністратора та публікується з підписаними інсталяторами x64 і ARM64 у релізах OpenClaw. Завантажте найновіший стабільний інсталятор зі сторінки релізів OpenClaw: Якщо посилання для завантаження вище повертає 404, перейдіть на сторінку релізів і знайдіть ресурси OpenClawCompanion-Setup-* в останньому релізі. Після встановлення запустіть OpenClaw Companion з меню «Пуск» або системного трея. Інсталятор також додає ярлики для налаштування Gateway, чату, параметрів, перевірки оновлень і видалення.

​
Що входить до Windows Hub

  • стан у системному треї та запуск під час входу
  • початкове налаштування для локального Gateway у WSL, яким володіє застосунок
  • параметри підключення для локальних, віддалених і тунельованих через SSH Gateway
  • нативне вікно чату та доступ до браузерного Control UI
  • діагностика Command Center для сеансів, використання, каналів, вузлів, сполучення та команд відновлення
  • режим вузла Windows для керованих агентом canvas, екрана, камери, сповіщень, стану пристрою, перетворення тексту на мовлення, перетворення мовлення на текст і контрольованого system.run
  • режим локального сервера MCP для клієнтів MCP, як-от Claude Desktop, Claude Code і Cursor

​
Перший запуск

Під час першого запуску Windows Hub відкриває налаштування, якщо немає придатного збереженого Gateway. Найшвидший шлях — Налаштувати локально, що створює WSL-дистрибутив OpenClawGateway, яким володіє застосунок, установлює всередині нього Gateway і сполучає застосунок. Це не експортує й не змінює ваш наявний дистрибутив Ubuntu. Виберіть Розширене налаштування або відкрийте вкладку Connections, якщо у вас уже є Gateway. Ви можете підключитися до:
  • локального Gateway на цьому ПК
  • WSL Gateway на цьому ПК
  • віддаленого Gateway за URL і токеном або кодом налаштування
  • Gateway, доступного через SSH-тунель
Коли налаштування завершиться, піктограма в треї стане зеленою. Відкрийте Command Center із трея, щоб підтвердити підключення, сполучення, стан вузла та справність каналу.

​
Режим вузла Windows

Windows Hub може реєструватися як повноцінний вузол OpenClaw. Після цього агент може використовувати оголошені нативні можливості Windows через Gateway. Поширені команди:
  • canvas.present, canvas.hide, canvas.navigate, canvas.eval, canvas.snapshot
  • screen.snapshot і, з явною згодою, screen.record
  • camera.list і, з явною згодою, camera.snap, camera.clip
  • system.notify, system.run, system.run.prepare, system.which
  • location.get, device.info, device.status
  • stt.transcribe, tts.speak
Режим вузла потребує сполучення з Gateway. Якщо застосунок показує запит на сполучення, схваліть його з хоста Gateway: 
openclaw devices list
openclaw devices approve <request-id>
openclaw nodes status
Gateway пересилає лише команди, які вузол оголошує і які дозволяє політика сервера. Команди, чутливі до приватності, як-от screen.record, camera.snap і camera.clip, потребують явної згоди gateway.nodes.allowCommands.

​
Режим локального MCP

Windows Hub може надавати той самий реєстр нативних можливостей Windows як локальний сервер MCP на loopback. Це корисно, коли потрібно, щоб локальні клієнти MCP керували можливостями Windows без запущеного OpenClaw Gateway. Увімкніть його в параметрах Windows Hub у розділі для розробників/розширених налаштувань. Застосунок показує endpoint loopback і bearer token після ввімкнення сервера. Матриця режимів:
Режим вузлаСервер MCPПоведінка
вимкненовимкненоНастільний застосунок лише для оператора
увімкненовимкненоПідключений до Gateway вузол Windows
вимкненоувімкненоЛише локальний сервер MCP
увімкненоувімкненоВузол Gateway плюс локальний сервер MCP

​
Нативні Windows CLI і Gateway

Для роботи передусім із термінала встановіть OpenClaw з PowerShell: 
iwr -useb https://openclaw.ai/install.ps1 | iex
Перевірте: 
openclaw --version
openclaw doctor
openclaw gateway status --json
Нативні сценарії Windows CLI і Gateway підтримуються й надалі вдосконалюються. Керований запуск використовує Windows Scheduled Tasks, коли вони доступні. Завдання зберігає читабельний скрипт gateway.cmd у каталозі стану OpenClaw, але запускає його через згенеровану обгортку WScript gateway.vbs, щоб фоновий Gateway не відкривав видимого вікна консолі. Якщо створення завдання заборонено, OpenClaw повертається до елемента входу в папці Startup для поточного користувача. Щоб установити службу Gateway: 
openclaw gateway install
openclaw gateway status --json
Якщо потрібне лише використання CLI без керованої служби Gateway: 
openclaw onboard --non-interactive --skip-health
openclaw gateway run

​
WSL2 Gateway

WSL2 лишається найбільш сумісним із Linux середовищем виконання Gateway у Windows. Windows Hub може налаштувати для вас WSL Gateway, яким володіє застосунок, або ви можете встановити вручну всередині власного дистрибутива. Ручне налаштування: 
wsl --install
# Or pick a distro explicitly:
wsl --list --online
wsl --install -d Ubuntu-24.04
Увімкніть systemd усередині WSL: 
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
Перезапустіть WSL з PowerShell: 
wsl --shutdown
Потім установіть OpenClaw усередині WSL за допомогою швидкого старту для Linux: 
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw gateway status

​
Автозапуск Gateway до входу у Windows

Для headless-налаштувань WSL переконайтеся, що повний ланцюг завантаження виконується навіть тоді, коли ніхто не входить у Windows. Усередині WSL: 
sudo apt-get install -y dbus-x11
sudo loginctl enable-linger "$(whoami)"
openclaw gateway install
У PowerShell від імені адміністратора: 
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec dbus-launch true" /sc onstart /ru "$env:USERNAME"
Замініть Ubuntu на назву вашого дистрибутива з: 
wsl --list --verbose
Примітка: Дві зміни порівняно зі старішими рецептами:
  • dbus-launch true замість /bin/true — У WSL ≥ 2.6.1.0 регресія (microsoft/WSL #13416) призводить до завершення дистрибутива через 15-20 секунд після виходу останнього клієнта, навіть якщо linger увімкнено. dbus-launch true як обхідний шлях підтримує процес-нащадок init активним (обговорення спільноти, microsoft/WSL #9245).
  • /ru "$env:USERNAME" замість /ru SYSTEM — WSL-дистрибутиви для окремих користувачів (типове налаштування) не видимі для облікового запису SYSTEM; завдання нібито виконується, але дистрибутив ніколи не запускається. Запуск від власного облікового запису уникає цього. Windows попросить ваш пароль під час створення завдання.
Після перезавантаження перевірте з WSL: 
systemctl --user is-enabled openclaw-gateway.service
systemctl --user status openclaw-gateway.service --no-pager

​
Надання доступу до служб WSL через LAN

WSL має власну віртуальну мережу. Якщо інший комп’ютер має отримати доступ до служби всередині WSL, перенаправте порт 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

New-NetFirewallRule -DisplayName "WSL SSH $ListenPort" -Direction Inbound `
  -Protocol TCP -LocalPort $ListenPort -Action Allow
Примітки:
  • SSH з іншого комп’ютера спрямовується на IP-адресу хоста Windows, наприклад ssh user@windows-host -p 2222.
  • Віддалені вузли мають вказувати досяжний URL Gateway, а не 127.0.0.1.
  • Використовуйте listenaddress=0.0.0.0 для доступу з LAN. Використовуйте 127.0.0.1 для доступу лише локально.

​
Усунення несправностей

​
Піктограма в треї не з’являється

Перевірте Task Manager на наявність OpenClaw.Tray.WinUI.exe. Якщо він запущений, відкрийте область прихованих піктограм трея та закріпіть його. Якщо він не запущений, запустіть OpenClaw Companion з меню «Пуск».

​
Локальне налаштування завершується невдало

Відкрийте журнал налаштування з Windows Hub або перевірте: 
notepad "$env:LOCALAPPDATA\OpenClawTray\Logs\Setup\easy-setup-latest.txt"
Поширені причини: вимкнений WSL, заблокована віртуалізація, застарілий стан WSL, яким володіє застосунок, або збій мережі під час встановлення пакета Gateway.

​
Застосунок повідомляє, що потрібне сполучення

Схваліть запит оператора або вузла з Gateway: 
openclaw devices list
openclaw devices approve <request-id>
Якщо пристрій уже мав токен, перепідключіться з вкладки Connections після схвалення.

​
Вебчат не може досягти віддаленого Gateway

Віддалений вебчат потребує HTTPS або localhost. Для самопідписаних сертифікатів довірте сертифікат у Windows або використовуйте SSH-тунель до URL localhost.

​
screen.snapshot, камера або аудіокоманди не працюють

Підтвердьте дозволи Windows для камери, мікрофона, захоплення екрана та сповіщень. Пакетні інсталяції оголошують захищені можливості, але Windows усе одно може запитати дозвіл під час першого використання команди.

​
Не працює підключення до Git або GitHub

Деякі мережі блокують або обмежують HTTPS до GitHub. Якщо git clone або gh auth login завершується невдало, спробуйте іншу мережу, VPN або HTTP/HTTPS-проксі. Для автентифікації gh на основі токена в поточному сеансі: 
$env:GH_TOKEN="<your-token>"
gh auth status
gh auth setup-git
Ніколи не комітьте токени й не вставляйте їх в issues або pull requests.

​
Пов’язане