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 list
openclaw devices approve <requestId>
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 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 --version
openclaw doctor
openclaw gateway status --json

Для управляемого запуска по возможности используются запланированные задачи Windows. Задача сохраняет читаемый сценарий 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

Gateway в WSL2

WSL2 остаётся наиболее совместимой с Linux средой выполнения Gateway в Windows. Windows Hub может настроить для вас управляемый приложением WSL Gateway, либо его можно установить вручную в собственном дистрибутиве. Ручная настройка:

wsl --install
# Или явно выберите дистрибутив:
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

Для 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 по локальной сети

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 list
openclaw 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 status
gh auth setup-git

Никогда не добавляйте токены в коммиты и не вставляйте их в задачи или запросы на включение изменений.

Platforms overview

macOS companion app

Рекомендуется: Windows Hub

Что входит в Windows Hub

Первый запуск

Режим узла Windows

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

Нативные CLI и Gateway для Windows

Gateway в WSL2

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

Предоставление доступа к службам WSL по локальной сети

Устранение неполадок

Значок не отображается в области уведомлений

Локальная настройка завершается с ошибкой

Приложение сообщает, что требуется сопряжение

Веб-чат не может подключиться к удалённому Gateway

Команды `screen.snapshot`, камеры или аудио завершаются с ошибкой

Не работает подключение к Git или GitHub

Связанные разделы

​Рекомендуется: Windows Hub

​Что входит в Windows Hub

​Первый запуск

​Режим узла Windows

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

​Нативные CLI и Gateway для Windows

​Gateway в WSL2

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

​Предоставление доступа к службам WSL по локальной сети

​Устранение неполадок

​Значок не отображается в области уведомлений

​Локальная настройка завершается с ошибкой

​Приложение сообщает, что требуется сопряжение

​Веб-чат не может подключиться к удалённому Gateway

​Команды screen.snapshot, камеры или аудио завершаются с ошибкой

​Не работает подключение к Git или GitHub

​Связанные разделы

Рекомендуется: Windows Hub

Что входит в Windows Hub

Первый запуск

Режим узла Windows

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

Нативные CLI и Gateway для Windows

Gateway в WSL2

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

Предоставление доступа к службам WSL по локальной сети

Устранение неполадок

Значок не отображается в области уведомлений

Локальная настройка завершается с ошибкой

Приложение сообщает, что требуется сопряжение

Веб-чат не может подключиться к удалённому Gateway

Команды `screen.snapshot`, камеры или аудио завершаются с ошибкой

Не работает подключение к Git или GitHub

Связанные разделы