OpenClaw 2026 после установки
doctor, здоровье Gateway, исправления macOS/Linux/WSL2

Чтение ~15 мин · MACCOME

Если вы закончили гайд по установке OpenClaw, но по-прежнему видите «CLI жив, Gateway мёртв», «таймауты модели» или «демон в WSL2 не держится», нужны постинсталляционная проверка и разбор по симптомам, а не копипаст шагов установки. Статья согласована с гайдом на три платформы, продакшен-Docker и продвинутыми материалами про Secrets/PDF: даётся только матрица симптомов, шестишаговый runbook и три жёстких ops-метрики, плюс отличия WSL2 от нативного Linux и macOS.

Установлено ≠ здорово: пять ловушек разбора

Системы с долгоживущим Gateway, исходящим трафиком к моделям и локальными демонами часто ломаются как «каждый кусок в отдельности нормальный». На дежурстве отделяйте разовую ошибку конфигурации от нестабильной сети и политик питания. Сначала согласуйте пять ловушек ниже, затем переходите к таблице.

  1. Считать «установка прошла» равным «сервис здоров»: пакеты стоят, а сервис не зарегистрирован, никто не слушает или health падает — автоматизация всё равно дёргается.
  2. Смешивать API-ключи с egress: валидные ключи за корпоративным прокси или при региональных блоках чаще выглядят как таймауты, а не 401.
  3. Игнорировать адреса привязки Gateway: только localhost или только внутри контейнера меняют пути доступа для других процессов.
  4. Путать WSL2 с нативным Windows: DrvFS и ext4 по-разному ведут себя на I/O и inotify; пути выглядят одинаково, поведение — нет.
  5. Смотреть только последнюю строку лога: выровняйте метки времени по слоям модели, Gateway и демона до поиска первопричины.

Матрица симптомов: сначала классификация

Используйте таблицу на дежурстве; точные имена CLI зависят от установленной версии OpenClaw. Перед глубоким копанием предпочтительны doctor или эквивалентные проверки.

Что видитеВероятное направлениеСначала попробуйте
Процесс сразу выходитВерсия Node, права, рабочий каталогСвериться с официальным базовым Node; запустить doctor; проверить пользователя установки и права на каталог данных
Порт Gateway «молчит»Адрес привязки, конфликт порта, фаерволПодтвердить слушатель; curl health локально; проверить хост и upstream security groups
Таймауты модели или обрыв стримаEgress, DNS, прокси, регион, квотаМинимальный тестовый запрос; обойти прокси; проверить квоту и регион endpoint
Только WSL2, на «голом» Linux окПроизводительность ФС, вирт-сеть, пробелы systemdДержать репозитории на ext4 в WSL; не таскать огромные деревья через /mnt/c; проверить стратегию systemd/user-session
Падает после сна/обновленияПолитика питания ноутбука и восстановление демонаНастройки энергии; умирают ли демоны вместе с GUI-сессией; нужен ли выделенный хост
bash
# Проверки после установки (имена могут совпадать с вашим CLI)
openclaw doctor
curl -fsS "http://127.0.0.1:${OPENCLAW_GATEWAY_PORT:-PORT}/health" || true
warning

WSL2: тяжёлые сборки или файловые вотчеры на /mnt/c медленнее и могут терять события по сравнению с Linux-ФС; долгоживущие Gateway лучше держать репозитории и данные на томе WSL Linux и отдельно проверять жизненный цикл systemd/сессии.

Шестишаговый runbook после установки

Шаги повторяют дисциплину Docker health-check, но для bare-metal или гибрида: каждый критерий приёмки должен воспроизводиться.

  1. Зафиксировать тройку версий: OpenClaw, мажор Node, патч ОС — пересматривать вместе при апгрейдах.
  2. Запустить doctor: разложить предупреждения по корзинам конфиг, сеть и права, прежде чем их «закрывать».
  3. Минимальный вызов модели: самый короткий промпт и таймаут, чтобы отделить auth, квоту и сеть.
  4. Слушатель Gateway и health: сначала пройти loopback-пробы, затем кросс-процессные тесты; согласовать прокси с префиксами на хосте.
  5. Жизненный цикл демона: launchd, systemd, службы Windows или объекты входа — проверить восстановление после переподключения.
  6. Вести индекс симптомов: частые строки ошибок привязывать к фиксам во внутренней вики.

Три метрики для тикетов на изменения

Они не заменяют документацию, но выравнивают ревью и дежурство.

  1. Граница Node/рантайма: поддерживаемые мажоры Node и политика только LTS — сначала откат Node, потом охота на баги приложения.
  2. Определение health-check: HTTP 200 ≠ готовность — зафиксировать путь пробы, таймауты, зависимость от модели.
  3. Настройки логирования: уровни Gateway и клиента, пути, ротация — не заполнять диск долгим debug навсегда.

Почему «у меня на ноутбуке работает» ≠ продакшен-Gateway

Сон, обновления и запросы прав прерывают долгоживущие процессы; у WSL2 и нативного Windows сеть расходится ещё сильнее. Если Gateway OpenClaw должен быть опорой для команды, выделенный наблюдаемый хост на Apple Silicon обычно выигрывает у бесконечных локальных костылей.

MACCOME предлагает мультирегиональные bare-metal удалённые Mac, подходящие для стабильных Gateway и автоматизации; после гайдов по установке и Docker, если сон и восстановление демона всё ещё мешают, начните с центра помощи и сопоставьте тарифы и регионы.

Для краткосрочной отладки на ноутбуке завершите этот шестишаговый чеклист и заскриптуйте health-проверки; когда в игру входят CI или агенты 24/7, оцените перенос на выделенный удалённый Mac вместо наслоения локальных патчей.

Вопросы

В гайде по установке уже есть команды — зачем эта статья?

Гайд на три платформы описывает, как установить; эта статья — как доказать здоровье и разобрать симптомы.

Это дублирует статью про продакшен Docker?

Нет. Продакшен-runbook по Docker про образы и Compose; здесь — постинсталляционные проверки, пробы и разрыв WSL2/натив.

Сначала читать продвинутый материал про Secrets?

Гovernance — в продвинутом runbook; если модели всё ещё падают, сначала матрица здесь, затем ротация и аудит. Стабильную плоскадку хоста смотрите в тарифах и в центре помощи по сессиям и подключению.