Если официальный install.sh или install.ps1 уже отработал, а терминал сообщает Gateway не найден, порт по умолчанию не слушает и Control UI не открывается — это обычно не «ошибка установки», а частый в 2026 полустатус установки: CLI на месте, daemon Gateway и финализация onboard не замкнуты. Для продакшена: 10-минутная лестница приёмки, шестишаговый runbook восстановления, матрица и checklist вывода — вместе с кроссплатформенной установкой и базовой линией Node 24.
Около марта 2026 сообщество зафиксировало: на чистом хосте скрипт лишь обновлял существующий сервис Gateway без первого daemon install — визуальный успех, фактически без Gateway. Даже после исправлений в upstream старые машины могут сохранять следы. При двух и более признаках ниже — этот runbook, а не полная переустановка ОС.
openclaw-gateway или эквивалент отсутствует: which openclaw есть, но бинарник Gateway или symlink не в ожидаемом каталоге PATH.
Порт по умолчанию (часто 18789) без listener: openclaw gateway status — not running или цикл выходов; openclaw logs пустой или короткий.
Control UI / Dashboard без ответа: Таймаут браузера на локальной панели — не путать с auth: процесс не запущен.
onboard --install-daemon с ошибкой или пропущен: в v2026.3.x иногда падала проверка systemd — конфиг записан, сервис не установлен.
Регрессия после обновления: два openclaw в PATH, doctor — split brain — сначала восстановление после split brain, затем приёмка Gateway по этой статье.
Только channels probe падает, Gateway running: самая рискованная фаза пройдена — см. статью по auth; не удаляйте конфиг вслепую.
| Проверка | Здорово (prod) | Полуустановка (эта статья) | Ложный успех |
|---|---|---|---|
openclaw gateway status | Runtime: running; Probe ok | not running / команда отсутствует | running, порт не слушает (устаревший PID-файл) |
openclaw doctor | нет блокеров; validate ok | daemon не установлен или аномалия PATH | только warnings, проигнорированы |
channels status --probe | Connectivity probe: ok | каналы не настроены (нормально на чистой фазе Gateway) | ошибка probe ошибочно принята за «сломанную установку» |
| Node runtime | Node 24 (oder dokumentiertes Minimum 22.14+) | смесь system Node и nvm, пользователь сервиса видит другое | в интерактивной shell node -v ок, в unit systemd старая версия |
Последняя «зелёная» строка скрипта не заменяет prod-приёмку — status, doctor и порт должны сходиться.
Порядок важен: сначала Gateway запускается и переживает рестарт, затем onboard для моделей и каналов — не крутите openclaw.json, пока процесса нет.
Зафиксировать контекст: openclaw --version, which -a openclaw, канал установки (curl / npm -g / git).
Диагностическая лестница: openclaw status → openclaw gateway status → openclaw logs --follow (второй терминал) → openclaw doctor.
Запуск Gateway: openclaw gateway start; если daemon не установлен openclaw onboard --install-daemon (токен и минимальный конфиг в мастере).
CLI есть, Gateway нет: после baseline Node 24 при необходимости npm install -g openclaw --force; в контейнерах — Docker/Podman, не насильный systemd.
Версия: при регрессии daemon v2026.3.2 — v2026.3.1 или сборка с PR #48649; rollback в change ticket.
Prod-приёмка: openclaw channels status --probe, loopback/Token, повтор после рестарта; macOS: удалённый Mac launchd, Linux: Ubuntu systemd.
# 10-минутная приёмка (2026) openclaw status openclaw gateway status openclaw doctor openclaw gateway start openclaw onboard --install-daemon # если daemon не установлен openclaw channels status --probe
Примечание: Официальные скрипты рекомендуют Node 24 на macOS/Linux. Сначала CVE-2026-25253 и baseline Node 24, затем этот runbook — не открывайте Gateway без выравнивания security.
Внимание: Не «лечите» полуустановку публичным bind Gateway; по умолчанию 127.0.0.1, удалённый доступ — Tailscale или туннель; см. статьи по безопасности Gateway.
onboard --install-daemon делает Gateway перезапускаемым сервисом — без шага остаётся полуустановка.doctor und gateway status регулярно логировать; issue #48272: успех в логе установки не заменяет приёмку на уровне процесса.Gateway на спящем ноутбуке или общей dev-машине после обновления ОС легко возвращается в полустатус. Выделенный постоянно online узел macOS лучше подходит как хост агента. Кому нужна Mac-мощность как VPS по SSH с повторяемыми скриптами приёмки, обычно подходит аренда Mac Mini в облаке NodeMini — та же операционная модель, что remote OpenClaw и CI на одном хосте; 10-минутные проверки закрепляются в стандартных образах и runbook.
Раздел 3: gateway start und onboard --install-daemon, Daemon mit doctor verifizieren. Kapazität: цены аренды Mac Mini.
Там — первая установка Windows/macOS/Linux; здесь — скрипт готов, Gateway не готов. Читать обе статьи.
Команды диагностики одинаковы; постоянство: launchd vs. systemd. Доступ: центр помощи Cloud Mac.