Platforms overview
Windows
OpenClaw поставляется с нативным приложением-компаньоном Windows Hub, а также поддерживает CLI в Windows. Используйте Windows Hub как настольное приложение для настройки, отображения состояния в области уведомлений, чата, диагностики Command Center и возможностей узла Windows. Используйте установщик PowerShell для непосредственной установки CLI/Gateway. Используйте WSL2 для наиболее совместимой с Linux среды выполнения Gateway.
Рекомендуется: Windows Hub
Windows Hub — нативное приложение-компаньон WinUI для Windows 10 20H2+ и Windows 11. Оно устанавливается без прав администратора и предоставляет подписанные установщики x64 и ARM64 на собственной странице релизов.
Windows Hub выпускается независимо от CLI и Gateway OpenClaw. Загрузите
последний стабильный установщик Hub со
страницы релизов Windows Hub
или напрямую через releases/latest/download:
Если ссылка выше возвращает ошибку 404, перейдите на страницу релизов Windows Hub и откройте последний стабильный релиз Windows Hub. Обычные стабильные релизы OpenClaw также содержат зеркальную копию закреплённой и проверенной для релиза сборки Windows Hub; эта копия может отставать от более нового отдельного релиза Hub.
После установки запустите OpenClaw Companion из меню «Пуск» или области уведомлений. Установщик также добавляет ярлыки Gateway Setup, Chat, Settings, Check for Updates и удаления приложения.
Что входит в Windows Hub
- Состояние в области уведомлений и запуск при входе в систему.
- Первоначальная настройка локального WSL Gateway, управляемого приложением.
- Параметры подключения для локальных и удалённых Gateway, а также Gateway через SSH-туннель.
- Нативное окно чата и доступ к браузерному Control UI.
- Диагностика Command Center для сеансов, использования, каналов, узлов, сопряжения и команд восстановления.
- Режим узла Windows для управляемых агентом холста, экрана, камеры,
уведомлений, состояния устройства, речи и контролируемого
system.run. - Режим локального сервера MCP для клиентов MCP, таких как Claude Desktop, Claude Code и Cursor.
Первый запуск
При первом запуске Windows Hub открывает настройку, если отсутствует пригодный сохранённый
Gateway. Самый быстрый вариант — Set up locally: он подготавливает
управляемый приложением дистрибутив WSL OpenClawGateway, устанавливает в него Gateway и
сопрягает приложение. При этом существующий дистрибутив Ubuntu не экспортируется и не изменяется.
Выберите Advanced setup или откройте вкладку Connections, если у вас уже есть Gateway. Можно подключиться к:
- локальному Gateway на этом ПК
- WSL Gateway на этом ПК
- удалённому Gateway по URL и токену или коду настройки
- Gateway, доступному через SSH-туннель
После завершения настройки значок в области уведомлений станет зелёным. Откройте Command Center из области уведомлений, чтобы проверить подключение, сопряжение, состояние узла и работоспособность каналов.
Режим узла Windows
Windows Hub может зарегистрироваться как узел OpenClaw, чтобы агент мог использовать объявленные нативные возможности Windows через Gateway. Команды узла должны быть объявлены узлом и разрешены политикой 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 |
| Речь | talk.ptt.start, talk.ptt.stop, talk.ptt.cancel, talk.ptt.once, talk.speak |
Для режима узла требуется сопряжение с Gateway. Если приложение показывает запрос на сопряжение, подтвердите его на хосте Gateway:
openclaw devices listopenclaw devices approve <requestId>openclaw nodes statusGateway перенаправляет только те команды, которые объявлены узлом и
разрешены политикой сервера. Для чувствительных к конфиденциальности команд, таких как screen.record, camera.snap
и camera.clip, требуется явное включение gateway.nodes.allowCommands.
Режим локального MCP
Windows Hub может предоставлять тот же реестр нативных возможностей Windows в виде локального сервера MCP на loopback-интерфейсе, чтобы локальные клиенты MCP могли управлять возможностями Windows без запущенного OpenClaw Gateway.
Включите его в Windows Hub Settings в разделе для разработчиков/расширенных настроек. После включения сервера приложение покажет loopback-конечную точку и bearer-токен.
Матрица режимов:
| Режим узла | Сервер MCP | Поведение |
|---|---|---|
| off | off | Настольное приложение только для оператора |
| on | off | Узел Windows, подключённый к Gateway |
| off | on | Только локальный сервер MCP |
| on | on | Узел Gateway и локальный сервер MCP |
Нативные CLI и Gateway для Windows
Для работы преимущественно через терминал установите OpenClaw из PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iexПроверка:
openclaw --versionopenclaw doctoropenclaw gateway status --jsonДля управляемого запуска по возможности используются запланированные задачи Windows. Задача сохраняет
читаемый сценарий gateway.cmd в каталоге состояния OpenClaw, но запускает его
через сгенерированную оболочку WScript gateway.vbs, поэтому фоновый Gateway
не открывает видимое окно консоли. Если создание задачи запрещено, OpenClaw
переключается на элемент автозагрузки текущего пользователя в папке Startup.
Установите службу Gateway:
openclaw gateway installopenclaw gateway status --jsonДля использования только CLI без управляемой службы Gateway:
openclaw onboard --non-interactive --skip-healthopenclaw gateway runGateway в WSL2
WSL2 остаётся наиболее совместимой с Linux средой выполнения Gateway в Windows. Windows Hub может настроить для вас управляемый приложением WSL Gateway, либо его можно установить вручную в собственном дистрибутиве.
Ручная настройка:
wsl --install# Или явно выберите дистрибутив:wsl --list --onlinewsl --install -d Ubuntu-24.04Включите systemd внутри WSL:
sudo tee /etc/wsl.conf >/dev/null <<'EOF'[boot]systemd=trueEOFПерезапустите WSL из PowerShell:
wsl --shutdownЗатем установите OpenClaw внутри WSL, следуя инструкции по быстрому запуску в Linux:
curl -fsSL https://openclaw.ai/install.sh | bashopenclaw gateway statusАвтозапуск Gateway до входа в Windows
Для WSL без графического интерфейса убедитесь, что вся цепочка загрузки выполняется, даже если никто не входит в Windows.
Внутри WSL:
sudo apt-get install -y dbus-x11sudo 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После перезагрузки выполните проверку из WSL:
systemctl --user is-enabled openclaw-gateway.servicesystemctl --user status openclaw-gateway.service --no-pagerПредоставление доступа к службам WSL по локальной сети
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 "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Примечания:
- При подключении по SSH с другой машины указывайте IP-адрес хоста Windows, например
ssh user@windows-host -p 2222. - Удалённые узлы должны указывать доступный URL Gateway, а не
127.0.0.1. - Используйте
listenaddress=0.0.0.0для доступа из локальной сети, а127.0.0.1— только для локального доступа.
Устранение неполадок
Значок не отображается в области уведомлений
Проверьте наличие OpenClaw.Tray.WinUI.exe в диспетчере задач. Если процесс выполняется, откройте
область скрытых значков и закрепите его. Если нет, запустите OpenClaw Companion из
меню «Пуск».
Локальная настройка завершается с ошибкой
Откройте журнал настройки из Windows Hub или просмотрите:
notepad "$env:LOCALAPPDATA\OpenClawTray\Logs\Setup\easy-setup-latest.txt"Распространённые причины: отключённый WSL, заблокированная виртуализация, устаревшее состояние управляемого приложением WSL или сетевая ошибка при установке пакета Gateway.
Приложение сообщает, что требуется сопряжение
Подтвердите запрос оператора или узла в Gateway:
openclaw devices listopenclaw devices approve <requestId>Если у устройства уже был токен, после подтверждения повторно подключитесь на вкладке 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 statusgh auth setup-gitНикогда не добавляйте токены в коммиты и не вставляйте их в задачи или запросы на включение изменений.
