Если вы запускаете OpenClaw на Windows с Docker Desktop и WSL2 и получаете зависшие установщики, URL с токеном без доступности, контейнеры в состоянии running при недоступности хостового CLI или рассинхрон версий CLI и образа после апгрейда, эта страница — симптомно-ориентированный чеклист для тикетов. Дополняет гайд установки Windows/macOS/Linux, Compose pairing (1006/1008), образы GHCR и Control UI, triage Gateway doctor, а также SSH LocalForward к удалённому Gateway и нативные пути macOS. Официальные заметки: OpenClaw Gateway Troubleshooting.
docker compose up дают двойные Gateway или конкуренцию за loopback-порты из документации (проверка openclaw gateway status).openclaw --version на хосте расходится с CLI в контейнере; предупреждения doctor читают как сбой модели.Не концептуальный тур, а исполнимый triage для Windows и Docker. macOS, Linux systemd и runbooks Tailscale делят ту же лестницу верификации, но другие обязанности хоста.
Если вы уже используете runbook по no-reply и ошибкам модели, считайте эту статью предпосылками до слоёв моделей и каналов.
На практике полезно фиксировать в тикете версию дистрибутива WSL и канал Docker Desktop: один и тот же compose-файл может ломаться только из-за внутреннего DNS. Перед переустановкой OpenClaw чаще эффективнее wsl --shutdown и проверка корпоративного VPN, чем повторный pull без pin digest.
В полуофлайн-средах критично сверять digest образов с внутренним registry и TTL метаданных зеркала; иначе pull выглядит «случайно падающим». Этот контур пересекается с GHCR runbook—держите артефакты проверки в одном change-тикете.
| Кластер симптомов | Первые проверки (<5 мин) | Следующий шаг |
|---|---|---|
| Мастер заморожен / URL не появляется | Состояние Docker Desktop; WSL включён; свободный диск >20 ГБ (пример порога, калибруйте) | Поднять Gateway через документированный compose, читать docker logs; не дублировать старт скриптом и вручную |
| Контейнер running, хостовый CLI не коннектится | Конфликты портов; бинды, видимые только внутри container network | openclaw gateway status / openclaw status; сверить TOKEN и namespaces со статьёй про Compose pairing |
| Регрессия сразу после апгрейда | Согласованность хостового CLI и тега образа; старые volumes с конфликтующим конфигом | Выровнять версии, запустить openclaw doctor; по доке принудительно переустановить Gateway с контрольными точками бэкапа |
Комьюнити-лор (не гарантия вендора): часть пользователей прерывает зависший мастер и переходит на docker compose up -d. Если трогали pending JSON или недокументированные флаги, откатитесь к актуальной официальной доке—в проде не полагайтесь на скрытые переключатели.
wsl --version, openclaw --version, digest образа—в тикет.openclaw status → openclaw gateway status → openclaw doctor → openclaw channels status --probe (точные команды по каналу установки).Между шагами 3 и 4 выведите редактированный срез env контейнера и маппинг docker port до настройки промптов—много «no-reply» это транспорт не готов, не температура.
С SSH-перенаправлением на удалённый Gateway ноутбуку нужны только TCP к форвард-порту и один источник TOKEN—не публикуйте порты Gateway без аутентификации в публичный интернет.
wsl --status docker version openclaw --version openclaw gateway status openclaw doctor
doctor или зафиксировать явные отступления—иначе не мержить изменения пайплайна, зависящие от Gateway.Политики сна, Patch Tuesday и апгрейды Docker Desktop режут доступность на непредсказуемые куски. Общие «у меня работает» Gateway усложняют гомогенные образы, стабильные listeners и аудитные логи—не дешевле.
Относительно этого, когда нужны предсказуемые хосты Apple Silicon, стабильный региональный egress и документированные SSH/tailnet-топологии для 7×24 Gateway, оставляя Windows Docker dev-песочницей, облачные Mac mini MACCOME обычно безопаснее: выделенные узлы в шести регионах, гибкая аренда, эксклюзивный диск и процессное пространство—согласовано с другими runbooks OpenClaw и удалённого Mac.
Передача смены требует тегов образов, ревизий compose-сниппетов, политики прокси и примеров вывода команд. Если коллега не воспроизводит на другой Windows-машине, runbook неполон.
Относительно нативного macOS runbook: та же лестница, другие обязанности хоста—не смешивать семантику launch.
Финальные пять минут: Docker single-truth готов? Gateway single-track? Doctor чист? Только после трёх «да» открывайте triage моделей и каналов.
FAQ
URL с токеном напечатан, браузер не открывает—Gateway мёртв?
Дождитесь готовности движка и контейнера, проверьте прокси и порты. Стабильные выделенные хосты: цены аренды Mac mini и повторно цены аренды Mac mini для тарифов.
Можно ли вечно параллелить docker compose и официальный мастер?
Только для краткого triage—сойдитесь к одному источнику истины, чтобы избежать двойных Gateway и дрейфа токенов; обновите статьи pairing и doctor в том же тикете.