OPENCLAW 2026
POST_INSTALL_
GATEWAY_
PATH_FORCE.

Абстрактные серверные стойки

После npm install -g openclaw часто нет явной ошибки, но openclaw ask зависает, появляется openclaw-gateway: command not found или openclaw gateway status показывает отсутствие регистрации. Первичные причины: дрейф npm-prefix/PATH, пропуск шага регистрации шлюза, коллизия Node 22, launchd без интерактивных профилей. Здесь — матрица «симптом—доказательство—действие», пять шагов холодного старта, числовые пороги и FAQ; перекрёстно читайте install.sh в прод, LaunchAgent и токен, Chrome Relay 18792, v2026.5.x слои. Для чистой контрольной плоскости воспроизведите шаги на удалённом Mac MACGPU.

1. Разбор боли

Глобальный bin вне PATH, не выполнен openclaw gateway install, несколько Node, минимальное окружение launchd. Не начинайте с лимитов API. «Зелёные» логи установки не гарантируют замкнутый runtime-контур; параллельные глобальные npm на общих учётках делают which нестабильным. Логи на только чтение или сетевых томах дают циклы падений после «успеха».

2. Матрица

СигналПодозрениеДоказательство
command not foundPATHwhich openclaw, npm prefix -g
status: не установленрегистрациядо/после gateway install --force
интерактив OK, launchd нетplistEnvironmentVariables
только удалённоnon-login shellssh -t, домашний каталог

3. Пять шагов

Шаг 1 Зафиксировать тройку

node -v (22+), абсолютный which node.

Шаг 2 Prefix и PATH

npm config get prefix, RC оболочки, избегать sudo npm.

Шаг 3 Регистрация шлюза

openclaw gateway install, при необходимости --force, согласовать переменные LaunchAgent со статьёй о токене.

Шаг 4 Порты

Разделить loopback и SSH-туннель; зонд 18792 из материала Chrome Relay.

Шаг 5 Холодный рестарт и срезы логов

Полный стоп, старт, openclaw logs по окнам install/register/first-ask.

node -v; which node; npm prefix -g; which openclaw || true; which openclaw-gateway || true openclaw doctor openclaw gateway status || true openclaw gateway install --force openclaw gateway status

4. Три жёстких ворот

A: which openclaw-gateway непустой. B: без здорового gateway status не включать прод-трафик каналов. C: без холодного старта launchd не полагаться только на туннель с ноутбука. После B закрыть все SSH и перепроверить без ручного export PATH.

5. Кейс

npm зелёный, днём SSH ок, ночью всё упало — в plist не было ~/.npm-global/bin.

В мае 2026 команда на удалённом Mac mini крутила ключи API, пока не зафиксировала абсолютный Node 22 в plist и не выполнила gateway install --force с probe каналов. Статья v2026.5.x предполагает здоровую базу; иначе плагины и TTS лишь усиливают шум.

6. Отрасль

В 2026 CLI, шлюз и плагины версионируются раздельно. Успешный npm не закрывает контур. Windows/Linux допустимы, но растут переменные рабочего стола и браузера. Выделенный узел Apple Silicon ускоряет разбор «не зарегистрировано» против «сеть». До закупки железа зафиксируйте аудируемые чек-листы и доказательства холодного старта. Чтобы снизить трение, арендуйте удалённый Mac MACGPU и встройте этот runbook в шаблон релиза.

Шлюз на Windows или Linux может работать в лаборатории, но при смешении графических пайплайнов и фоновых агентов дисперсия растёт. macOS как эталонная плоскость — это выбор в пользу воспроизводимости и стабильных логов, а не лозунг. Если команде нужен второй чистый контур без немедленного CAPEX, аренда удалённого Apple Silicon остаётся самым коротким путём к сопоставимым доказательствам.

7. Пороги

Холодный старт > 90 с до здорового status — разбор диска/АВ. Первый локальный ask > 25 с без ответа — сначала шлюз, не модели. Более двух --force в одном окне — ручной diff. Меньше трёх критичных PATH-записей — по умолчанию брак. Общие учётки автоматизации: отдельные npm-prefix и сериализация окон обслуживания.

8. FAQ

Doctor зелёный — which всё равно? Да. token_mismatch? 401 — статья о токене; нет процесса — здесь. sudo npm? Нет. Relay красный, gateway зелёный? Статья Chrome Relay. Смесь install.sh и npm? Двойные метаданные — одна стратегия на хост.