Пять типичных заблуждений под Windows и WSL2
OpenClaw в 2026 покрывает macOS, Linux и Windows (через WSL2). Инциденты накладывают три слоя: версия Node, может ли user-session systemd поднять Gateway и занят ли порт 18789 призрачными процессами. Сведение к «переустановить» даёт циклы падения 30–50 с на 2026.4.24, хотя корень — двойная регистрация Gateway на user и system уровне. Сначала классифицируйте тикет по сигнатуре, затем освобождайте порт, откатывайте dist-tag или переносите production Gateway на cloud Mac.
Ping cloud Mac из WSL ≠ здоровый Gateway: сеть ≠ openclaw gateway status active. Неверный remote URL на Node оставляет Windows в цикле рестартов.
onboard --install-daemon без systemd в WSL2: unit записан, но после обрыва SSH процесс не поднимается — каналы «случайно офлайн».
Gateway и на хосте Windows, и в WSL: два слушателя на 18789, призрачный EADDRINUSE, противоречивый doctor.
Сон ноутбука — каналы молчат: consumer Windows замораживает WSL. Webhooks — на бодрствующем cloud Mac master; Windows только Node или консоль.
Устаревшие ключи config после апгрейда без doctor: процесс Gateway жив, channels probe красный — часто дрейф схемы, не файрвол.
После метки сигнатуры настройте маршрутизацию моделей. Если master уже на cloud Mac — удалённый Node, Tailscale и миграция. Если Gateway на cloud-хосте ни разу не принят — сначала SSH-чеклист первого часа, и только потом демоны WSL, иначе шум рестартов на нестабильном master.
Матрица: нативный Windows, WSL2 или Gateway на cloud Mac
Консенсус 2026: не «Windows не умеет OpenClaw», а 7×24 control plane и webhooks каналов на стабильном хосте. Таблица сопоставляет эксперимент на ноутбуке, self-hosted Gateway в WSL и рекомендуемый split «cloud Mac master + Windows Node». Полная библиотека инцидентов — развёртывание Gateway и восстановление.
| Измерение | Windows нативно | WSL2 + systemd | Gateway cloud Mac + Win Node |
|---|---|---|---|
| Установка | install.ps1 | install.sh в Ubuntu | cloud Mac: install.sh; Win: только CLI/Node |
| Демон | Задача по расписанию | User systemd unit | cloud Mac: LaunchAgent; Win: без демона опционально |
| Каналы 7×24 | Сон / обновления | Пауза WSL | Каналы только на cloud Mac |
| Отладка | Пути / ACL | systemd + порты | Win: Node; cloud Mac: Gateway |
| Рекомендация 2026 | Короткое демо | Повтор prod-скриптов | распределённые команды |
Не ставьте production-каналы на «ноутбук не уснёт»; Gateway на loopback cloud Mac, Windows только node run.
Зафиксируйте в документации: какой cloud Mac держит webhooks, использует ли Windows только openclaw node run --remote wss://.... WSL может временно поднять Gateway для сравнения — не привязывайте один token канала параллельно на master, иначе двойное потребление и тихие потери. Docker vs bare metal: Docker vs install.sh; версии: апгрейд и откат. Рабочая копия Git на инстансе Mac — обычный репозиторий, не замена состоянию Gateway.
Предпроверка WSL2, Node 24 и послойный разбор EADDRINUSE
Перед продуктивным openclaw onboard --install-daemon в WSL: Node ≥ 22.16 (рекомендуется 24) и systemd=true в /etc/wsl.conf. На части сборок 2026.4.24 в WSL2: лог Gateway «стартовал», Control UI недоступна, EADDRINUSE каждые 30–50 с — типичная смягчение: pin 2026.4.22 и удаление дублирующих unit. Логи Gateway могут содержать идентификаторы каналов; в тикеты прикладывайте минимальные фрагменты по политике хранения персональных данных.
grep -q 'systemd=true' /etc/wsl.conf || echo '[boot]' >> /etc/wsl.conf && echo 'systemd=true' >> /etc/wsl.conf node -v curl -fsSL https://openclaw.ai/install.sh | bash openclaw onboard --install-daemon systemctl --user status openclaw-gateway lsof -i :18789 openclaw doctor openclaw gateway status
Если lsof показывает занятость 18789 при gateway status stopped, сначала осиротевшие процессы openclaw и параллельные unit в /etc/systemd/system и ~/.config/systemd/user. Оставьте одну user-unit, systemctl --user daemon-reload, перезапуск. При сохранении цикла зафиксируйте openclaw --version и оцените откат с 2026.4.24; в окне обслуживания — openclaw doctor --fix. Локальная отладка Control UI на dev-машине: файрвол только для 18789 на ноутбуке; production — Tailscale Serve к cloud Mac master, без публикации порта ноутбука в интернет.
Совет: сохраняйте systemctl --user status и lsof -i :18789 до и после onboard — отделяет двойной инстанс от дефекта версии.
Шесть шагов: приёмка WSL до smoke канала на master
Заморозить топологию: роль Windows (только Node / временный Gateway), регион cloud Mac, каналы только на master.
Предусловия WSL: systemd включён, node -v ≥ 22.16, при необходимости Node 24 в Ubuntu отдельно.
Master на cloud Mac: install.sh, onboard, LaunchAgent по чеклисту первого часа; loopback 18789 и gateway status зелёные.
Remote на Windows: node run --remote или Control UI на WSS master; при 1008 — devices approve на master (статья удалённого Node).
Остановить локальный Gateway в WSL (split): отключить user-unit, чтобы не конфликтовать с master по config канала.
Smoke на master: channels probe и реальное входящее на cloud Mac; Windows проверяет только выполнение tools, webhooks не на ноутбук.
Каждый шаг — поле в тикете: дата, версия, регион, результат probe. Распределённые команды экономят часы поддержки: операторы Windows не разбирают каждый лог Gateway master. Дисциплина записи отделяет инциденты WSL, версии и канала в разных ветках обсуждения.
Три порога эксплуатации и выбор Gateway на cloud Mac
Конфликт порта: три и более EADDRINUSE за десять минут при двух openclaw-gateway в одной WSL → двойной инстанс, сначала останов и очистка, потом апгрейд.
Нижняя граница Node: документация 2026 рекомендует Node 24; ниже 22.16 doctor может быть зелёным при падении плагинов — приложите node -v.
Приёмка split: после восстановления master — минимум три channels probe за десять минут; один сон ноутбука — переподключается только Node, каналы не зависят от laptop.
Примечание: пороги — внутренние ориентиры, не SLA вендора.
Привязка Gateway к ноутбуку Windows возвращает сон, feature-updates и заморозку WSL. Дешёвые Linux-VPS отрывают от browser automation macOS и нотаризации. Bare-metal cloud Mac как master, Windows как Node или UI сочетает близость Apple toolchain, дисциплину loopback и предсказуемые окна аренды в Сингапуре, Токио, Сеуле, Гонконге, US East и West. Для каналов 7×24 без ставки на consumer-железо базой служит аренда Mac mini MESHLAUNCH: суточная аренда целевого региона с шестью шагами и перезагрузкой хоста, затем месяц. Ёмкость: цены и центр помощи.
lsof -i :18789 и systemctl --user status openclaw-gateway, очистить unit и процессы, проверить pin 2026.4.24. См. руководство Gateway; аренда: цены.
Для коротких тестов — да. Production-каналы на cloud Mac master, Windows — node run. Шаги: SSH-чеклист первого часа.
Проверьте systemd в /etc/wsl.conf, выполните openclaw doctor. При split каналы остаются на cloud Mac: центр помощи.