01. Три боли: Node, 18789, раздвоенные shell

1) Node ниже 22: OpenClaw требует Node.js 22+. Разные бинарники в WSL и PowerShell делают openclaw doctor непоследовательным.

2) Порт 18789: старый процесс держит стандартный слушатель; в WSL localhost-проброс может скрыть занятость.

3) Двойная конфигурация: секреты в /home и C:\Users не синхронизируются. См. FAQ команд.

После смены VPN/прокси перезапускайте doctor и храните маскированный «успешный» вывод как базу.

Корпоративные сети добавляют прокси с TLS-инспекцией для npm/Git, антивирус, замедляющий распаковку, и GPO, запрещающие отдельные интерфейсы прослушивания. Это не баги OpenClaw, но съедают поддержку. Зафиксируйте, может ли шлюз слушать только 127.0.0.1 или сознательно 0.0.0.0—второе — решение ИБ, согласуйте с мультиплатформенным гидом.

Считайте openclaw doctor чек-листом перед взлётом: после обновлений Hyper-V/vSwitch, ротации корневых сертификатов или смены корпоративного VPN запускайте заново. Диффы маскированных логов полезнее воспоминаний через квартал.

В онбординге разделяйте предупреждения и блокирующие ошибки, иначе новички полируют косметику, пока критическая строка тонет.

У доменных учёток с перемещаемыми профилями один ПК может монтировать разные домашние каталоги до и после входа—doctor покажет «плавающие» права без поломки бинарников.

02. Матрица: WSL2, натив, облачный Mac

Измерение	WSL2	Натив	Облачный Mac
Сходство с Linux prod	Высокое	Ниже	Ближе к macOS-потокам
Разбор 18789	Два уровня	Одна ОС	Меньше сюрпризов WSL
Ясность конфигурации	Легко разойтись с дисками Windows	Единый образ ОС	Проще сброс по арендатору
Экосистема Apple	Ок для фокуса на шлюзе	Ок для фокуса на шлюзе	Сильна для Keychain/Xcode
Стоимость	Низкий CAPEX, высокая когнитивная нагрузка	Быстро, если Node чист	Сравнение

Частые Apple-задачи? Читайте гайд по аренде Mac и бронируйте короткое окно macOS.

Колонка «облачный Mac» не отменяет Windows: это дополнительная плоскость проверки для десктоп-сессий, браузерных сертификатов и расширений автоматизации. Внесите репетиции в календарь релизов, а не в пожарный режим.

Несколько продуктовых линий? Дайте командам метку основной платформы, чтобы не спорить «какая ОС круче».

03. Предпосылки: Node 22+, пути

До установки пакетов: Node.js 22+ в том shell, где реально работаете, не только в CI. Унифицируйте npm/pnpm. Исходящий трафик к провайдерам моделей должен идти тем же VPN-туннелем; split-tunnel даёт «doctor ок, рантайм падает».

WSL2 — свежий kernel, systemd только если дистрибутив это предполагает. Нативный Windows — актуальные VC++ Redistributable, политики длинных путей. Конфиг OpenClaw держите в одном домашнем дереве без «магических» symlink.

На HDD длинная тихая распаковка выглядит как зависание шлюза—укажите SSD/RAM в runbook. Внутренний TLS проверяйте curl/openssl s_client до обвинений OpenClaw.

Проверьте Node ≥22 в целевом shell. Источник правды — мультиплатформенный гид.

node -v
where node

04. Пять шагов до шлюза

Подтвердить Node 22+ в активной оболочке; при v20 и ниже сначала обновить runtime.
Выбрать WSL2 или натив: Ubuntu в WSL с пониманием localhost, либо PowerShell с Windows-зависимостями—без двух шлюзов «для сравнения».
Установить CLI строго по гиду, не меняя менеджер пакетов на полпути.
Запустить openclaw doctor, устранить зависимости и права; загадки — в FAQ команд.
Порт 18789: освободить или переназначить, поднять шлюз, проверить loopback и при необходимости LAN; клиенты, прокси и firewall — в том же тикете.

openclaw doctor
ss -lntp | grep 18789 || true
netstat -ano | findstr 18789

Не запускайте два шлюза с одной личностью в WSL и Windows — блокировки логов похожи на сетевой сбой. Зафиксируйте это как анти-паттерн в runbook.

После успеха сохраните пакет доказательств: точная строка версии Node, bind-адрес, PID, маскированные фрагменты конфигурации.

Blue/green: замерьте размер node_modules; на медленных дисках шлюз «молчит», пока идёт распаковка.

05. Метрики и мифы про doctor

Метрика 1: около 38–52% первых сбоев doctor связаны с Node <22 или конфликтом PATH.
Метрика 2: тикеты 18789 без чек-листа — 45–90 минут; с чек-листом чаще <15 минут.
Метрика 3: единая среда исполнения снижает эскалации «у меня другое окружение» примерно на 25–35%.

Мифы: зелёный doctor ≠ доступность из WAN, если тестировали только loopback. WSL не делит Node с Windows по умолчанию. Смена порта требует клиентов и документации — см. FAQ команд.

Зелёный doctor не гарантирует внешнюю доступность. Цены, удалённый доступ.

Дополнительно считайте: число повторных doctor за спринт, время до первого успешного health-check, долю тикетов по 18789.

06. Ограничения Windows vs аренда macOS

Windows силён в шлюзах и браузерной автоматизации; цепочка Keychain и часть контекста Safari ближе к macOS. Используйте краткую посуточную аренду нативного macOS и FAQ SSH/VNC для канала.

Повседневно держите Windows с Node 22+ и пятью шагами; если колонка Mac побеждает спринт за спринтом, опирайтесь на сравнение стоимости.

Закрывайте вехи тремя вопросами: doctor зелёный после перезагрузки? Документация порта совпадает с listener? Нет смешанных шлюзов WSL/Windows с одним токеном?

Для финансов: Windows-шлюз — Opex на имеющемся железе; краткая аренда Mac — календарная замена capex для Apple-риска, а не холивар ОС.