Windows

OpenClaw jest dostarczany z natywną aplikacją pomocniczą Windows Hub oraz obsługą CLI w systemie Windows. Windows Hub zapewnia aplikację komputerową z konfiguracją, stanem w zasobniku systemowym, czatem, diagnostyką Command Center i funkcjami węzła Windows. Instalator PowerShell umożliwia bezpośrednią instalację CLI/Gateway. WSL2 zapewnia środowisko uruchomieniowe Gateway o najwyższej zgodności z Linuksem.

Zalecane: Windows Hub

Windows Hub to natywna aplikacja pomocnicza WinUI dla systemów Windows 10 20H2+ i Windows 11. Instaluje się bez uprawnień administratora, a podpisane instalatory x64 i ARM64 są udostępniane na osobnej stronie wydań. Windows Hub jest publikowany niezależnie od CLI i Gateway OpenClaw. Najnowszy stabilny instalator Hub można pobrać ze strony wydań Windows Hub lub bezpośrednio przez releases/latest/download:

Jeśli któryś z powyższych linków zwraca błąd 404, należy przejść na stronę wydań Windows Hub i otworzyć najnowsze stabilne wydanie Windows Hub. Zwykłe stabilne wydania OpenClaw udostępniają również kopię przypiętej, zweryfikowanej pod kątem wydania kompilacji Windows Hub; ta kopia może być starsza od nowszego samodzielnego wydania Hub. Po instalacji należy uruchomić OpenClaw Companion z menu Start lub zasobnika systemowego. Instalator dodaje również skróty do konfiguracji Gateway, czatu, ustawień, sprawdzania aktualizacji i odinstalowywania.

Co zawiera Windows Hub

Stan w zasobniku systemowym i uruchamianie przy logowaniu.
Konfiguracja przy pierwszym uruchomieniu lokalnego Gateway WSL zarządzanego przez aplikację.
Ustawienia połączeń dla lokalnych i zdalnych Gateway oraz Gateway dostępnych przez tunel SSH.
Natywne okno czatu oraz dostęp do przeglądarkowego interfejsu Control UI.
Diagnostyka Command Center dotycząca sesji, użycia, kanałów, węzłów, parowania i poleceń naprawczych.
Tryb węzła Windows umożliwiający agentowi sterowanie kanwą, ekranem, kamerą, powiadomieniami, stanem urządzenia, funkcją rozmowy i kontrolowanym system.run.
Tryb lokalnego serwera MCP dla klientów MCP, takich jak Claude Desktop, Claude Code i Cursor.

Pierwsze uruchomienie

Przy pierwszym uruchomieniu Windows Hub otwiera konfigurację, jeśli nie ma zapisanego Gateway nadającego się do użycia. Najszybszą opcją jest Set up locally, która tworzy zarządzaną przez aplikację dystrybucję WSL OpenClawGateway, instaluje w niej Gateway i paruje aplikację. Nie powoduje to eksportowania ani modyfikowania istniejącej dystrybucji Ubuntu. Jeśli Gateway już istnieje, należy wybrać Advanced setup lub otworzyć kartę Connections. Można połączyć się z:

lokalnym Gateway na tym komputerze
Gateway WSL na tym komputerze
zdalnym Gateway za pomocą adresu URL i tokenu lub kodu konfiguracji
Gateway dostępnym przez tunel SSH

Po zakończeniu konfiguracji ikona w zasobniku zmieni kolor na zielony. Należy otworzyć Command Center z zasobnika, aby potwierdzić połączenie, parowanie, stan węzła i prawidłowe działanie kanałów.

Tryb węzła Windows

Windows Hub może zarejestrować się jako węzeł OpenClaw, dzięki czemu agent może korzystać ze zadeklarowanych natywnych funkcji Windows za pośrednictwem Gateway. Polecenia węzła muszą być zadeklarowane przez węzeł i dozwolone przez zasady Gateway, zanim zostaną wykonane; pełny model zezwoleń i odmów opisano w sekcji Węzły. Typowe polecenia:

Rodzina	Polecenia
Kanwa	`canvas.present`, `canvas.hide`, `canvas.navigate`, `canvas.eval`, `canvas.snapshot`
Ekran	`screen.snapshot`; `screen.record` wymaga jawnego włączenia
Kamera	`camera.list`; `camera.snap`, `camera.clip` wymagają jawnego włączenia
System	`system.notify`, `system.run`, `system.run.prepare`, `system.which`
Urządzenie	`location.get`, `device.info`, `device.status`
Rozmowa	`talk.ptt.start`, `talk.ptt.stop`, `talk.ptt.cancel`, `talk.ptt.once`, `talk.speak`

Tryb węzła wymaga parowania z Gateway. Jeśli aplikacja wyświetla żądanie parowania, należy je zatwierdzić na hoście Gateway:

openclaw devices list
openclaw devices approve <requestId>
openclaw nodes status

Gateway przekazuje tylko polecenia zadeklarowane przez węzeł i dozwolone przez zasady serwera. Polecenia wpływające na prywatność, takie jak screen.record, camera.snap i camera.clip, wymagają jawnego włączenia gateway.nodes.allowCommands.

Tryb lokalnego MCP

Windows Hub może udostępniać ten sam rejestr natywnych funkcji Windows jako lokalny serwer MCP w interfejsie pętli zwrotnej, dzięki czemu lokalni klienci MCP mogą sterować funkcjami Windows bez uruchomionego Gateway OpenClaw. Należy włączyć tę funkcję w ustawieniach Windows Hub w sekcji deweloperskiej/zaawansowanej. Po włączeniu serwera aplikacja wyświetla punkt końcowy pętli zwrotnej i token bearer. Macierz trybów:

Tryb węzła	Serwer MCP	Działanie
wyłączony	wyłączony	Aplikacja komputerowa tylko dla operatora
włączony	wyłączony	Węzeł Windows połączony z Gateway
wyłączony	włączony	Tylko lokalny serwer MCP
włączony	włączony	Węzeł Gateway oraz lokalny serwer MCP

Natywne CLI i Gateway dla Windows

Aby korzystać głównie z terminala, należy zainstalować OpenClaw z poziomu PowerShell:

iwr -useb https://openclaw.ai/install.ps1 | iex

Weryfikacja:

openclaw --version
openclaw doctor
openclaw gateway status --json

Zarządzane uruchamianie korzysta z Zaplanowanych zadań systemu Windows, gdy są dostępne. Zadanie zachowuje czytelny skrypt gateway.cmd w katalogu stanu OpenClaw, ale uruchamia go za pośrednictwem wygenerowanej otoczki WScript gateway.vbs, dzięki czemu działający w tle Gateway nie otwiera widocznego okna konsoli. Jeśli utworzenie zadania zostanie odrzucone, OpenClaw użyje zamiast tego elementu logowania dla bieżącego użytkownika w folderze Autostart. Instalacja usługi Gateway:

openclaw gateway install
openclaw gateway status --json

Aby korzystać wyłącznie z CLI bez zarządzanej usługi Gateway:

openclaw onboard --non-interactive --skip-health
openclaw gateway run

Gateway WSL2

WSL2 pozostaje środowiskiem uruchomieniowym Gateway o najwyższej zgodności z Linuksem w systemie Windows. Windows Hub może skonfigurować zarządzany przez aplikację Gateway WSL albo można zainstalować go ręcznie we własnej dystrybucji. Konfiguracja ręczna:

wsl --install
# Lub jawnie wybierz dystrybucję:
wsl --list --online
wsl --install -d Ubuntu-24.04

Włączenie systemd w WSL:

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

Ponowne uruchomienie WSL z poziomu PowerShell:

wsl --shutdown

Następnie należy zainstalować OpenClaw wewnątrz WSL, korzystając z instrukcji szybkiego startu dla Linuksa:

curl -fsSL https://openclaw.ai/install.sh | bash
openclaw gateway status

Automatyczne uruchamianie Gateway przed logowaniem do Windows

W bezobsługowych konfiguracjach WSL należy upewnić się, że cały łańcuch rozruchowy działa, nawet gdy nikt nie loguje się do systemu Windows. W WSL:

sudo apt-get install -y dbus-x11
sudo loginctl enable-linger "$(whoami)"
openclaw gateway install

W PowerShell uruchomionym jako administrator:

schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec dbus-launch true" /sc onstart /ru "$env:USERNAME"

Należy zastąpić Ubuntu nazwą dystrybucji uzyskaną za pomocą:

wsl --list --verbose

Dwie zmiany względem starszych instrukcji:

dbus-launch true zamiast /bin/true: w WSL >= 2.6.1.0 regresja (microsoft/WSL #13416) powoduje zakończenie bezczynnej dystrybucji 15-20 sekund po wyjściu ostatniego klienta, nawet przy włączonym trybie linger. dbus-launch true utrzymuje przy życiu proces potomny procesu init jako obejście problemu (dyskusja społeczności, microsoft/WSL #9245).
/ru "$env:USERNAME" zamiast /ru SYSTEM: dystrybucje WSL przypisane do użytkownika ( konfiguracja domyślna) nie są widoczne dla konta SYSTEM, więc zadanie pozornie się uruchamia, ale dystrybucja nigdy nie startuje. Uruchomienie go na własnym koncie pozwala tego uniknąć; podczas tworzenia zadania system Windows wyświetla monit o hasło.

Po ponownym uruchomieniu należy przeprowadzić weryfikację z poziomu WSL:

systemctl --user is-enabled openclaw-gateway.service
systemctl --user status openclaw-gateway.service --no-pager

Udostępnianie usług WSL w sieci LAN

WSL ma własną sieć wirtualną. Jeśli inny komputer musi uzyskać dostęp do usługi wewnątrz WSL, należy przekierować port systemu Windows na bieżący adres IP WSL. Adres IP WSL może zmieniać się po ponownym uruchomieniu, dlatego w razie potrzeby trzeba odświeżyć regułę przekierowania. Przykład w PowerShell uruchomionym jako administrator:

$Distro = "Ubuntu-24.04"
$ListenPort = 2222
$TargetPort = 22

$WslIp = (wsl -d $Distro -- hostname -I).Trim().Split(" ")[0]
if (-not $WslIp) { throw "Nie znaleziono adresu IP WSL." }

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

Uwagi:

Połączenie SSH z innego komputera jest kierowane na adres IP hosta Windows, np. ssh user@windows-host -p 2222.
Zdalne węzły muszą wskazywać osiągalny adres URL Gateway, a nie 127.0.0.1.
Należy używać listenaddress=0.0.0.0 dla dostępu z sieci LAN, a 127.0.0.1 dla dostępu wyłącznie lokalnego.

Rozwiązywanie problemów

Ikona nie pojawia się w zasobniku

Należy sprawdzić w Menedżerze zadań proces OpenClaw.Tray.WinUI.exe. Jeśli jest uruchomiony, należy otworzyć obszar ukrytych ikon zasobnika i przypiąć go. Jeśli nie jest uruchomiony, należy uruchomić OpenClaw Companion z menu Start.

Konfiguracja lokalna kończy się niepowodzeniem

Należy otworzyć dziennik konfiguracji z poziomu Windows Hub lub sprawdzić:

notepad "$env:LOCALAPPDATA\OpenClawTray\Logs\Setup\easy-setup-latest.txt"

Typowe przyczyny: wyłączone WSL, zablokowana wirtualizacja, nieaktualny stan WSL zarządzany przez aplikację lub błąd sieci podczas instalowania pakietu Gateway.

Aplikacja informuje, że wymagane jest parowanie

Należy zatwierdzić żądanie operatora lub węzła z poziomu Gateway:

openclaw devices list
openclaw devices approve <requestId>

Jeśli urządzenie miało już token, po zatwierdzeniu należy ponownie połączyć się z poziomu karty Connections.

Czat internetowy nie może uzyskać dostępu do zdalnego Gateway

Zdalny czat internetowy wymaga protokołu HTTPS lub hosta localhost. W przypadku certyfikatów podpisanych samodzielnie należy zaufać certyfikatowi w systemie Windows albo użyć tunelu SSH prowadzącego do adresu URL localhost.

Polecenia `screen.snapshot`, kamery lub dźwięku kończą się niepowodzeniem

Należy sprawdzić uprawnienia systemu Windows do kamery, mikrofonu, przechwytywania ekranu i powiadomień. Instalacje pakietowe deklarują chronione funkcje, ale system Windows może nadal wyświetlić monit przy pierwszym użyciu danej funkcji przez polecenie.

Połączenie z Git lub GitHub kończy się niepowodzeniem

Niektóre sieci blokują lub ograniczają ruch HTTPS do GitHub. Jeśli git clone lub gh auth login nie działa, należy wypróbować inną sieć, VPN albo serwer proxy HTTP/HTTPS. Uwierzytelnianie gh oparte na tokenie w bieżącej sesji:

$env:GH_TOKEN="<your-token>"
gh auth status
gh auth setup-git

Nigdy nie należy zatwierdzać tokenów w repozytorium ani wklejać ich do zgłoszeń lub pull requestów.

Platforms overview

macOS companion app

Zalecane: Windows Hub

Co zawiera Windows Hub

Pierwsze uruchomienie

Tryb węzła Windows

Tryb lokalnego MCP

Natywne CLI i Gateway dla Windows

Gateway WSL2

Automatyczne uruchamianie Gateway przed logowaniem do Windows

Udostępnianie usług WSL w sieci LAN

Rozwiązywanie problemów

Ikona nie pojawia się w zasobniku

Konfiguracja lokalna kończy się niepowodzeniem

Aplikacja informuje, że wymagane jest parowanie

Czat internetowy nie może uzyskać dostępu do zdalnego Gateway

Polecenia `screen.snapshot`, kamery lub dźwięku kończą się niepowodzeniem

Połączenie z Git lub GitHub kończy się niepowodzeniem

Powiązane

​Zalecane: Windows Hub

​Co zawiera Windows Hub

​Pierwsze uruchomienie

​Tryb węzła Windows

​Tryb lokalnego MCP

​Natywne CLI i Gateway dla Windows

​Gateway WSL2

​Automatyczne uruchamianie Gateway przed logowaniem do Windows

​Udostępnianie usług WSL w sieci LAN

​Rozwiązywanie problemów

​Ikona nie pojawia się w zasobniku

​Konfiguracja lokalna kończy się niepowodzeniem

​Aplikacja informuje, że wymagane jest parowanie

​Czat internetowy nie może uzyskać dostępu do zdalnego Gateway

​Polecenia screen.snapshot, kamery lub dźwięku kończą się niepowodzeniem

​Połączenie z Git lub GitHub kończy się niepowodzeniem

​Powiązane

Zalecane: Windows Hub

Co zawiera Windows Hub

Pierwsze uruchomienie

Tryb węzła Windows

Tryb lokalnego MCP

Natywne CLI i Gateway dla Windows

Gateway WSL2

Automatyczne uruchamianie Gateway przed logowaniem do Windows

Udostępnianie usług WSL w sieci LAN

Rozwiązywanie problemów

Ikona nie pojawia się w zasobniku

Konfiguracja lokalna kończy się niepowodzeniem

Aplikacja informuje, że wymagane jest parowanie

Czat internetowy nie może uzyskać dostępu do zdalnego Gateway

Polecenia `screen.snapshot`, kamery lub dźwięku kończą się niepowodzeniem

Połączenie z Git lub GitHub kończy się niepowodzeniem

Powiązane