Кому: инженерам, которые ставят OpenClaw на новые ноутбуки, WSL2, Linux-серверы или Windows-хосты и по умолчанию берут официальные curl- или PowerShell-ванлайнеры, но упираются в корпоративные прокси, свои УЦ, политику выполнения или дыры в PATH: скрипт «завершился», а openclaw отсутствует. Результат: гайд на три платформы как карта, эта статья как двухветочный runbook установки и pin: быстро, если ветка скрипта работает; иначе npm install -g с явными версиями; перед doctor и пост-инсталляционным триажем проверить Node и PATH. Структура: шесть заблуждений, матрица, сниппеты, шестишаговый runbook, три KPI, заключительные указания.
Официальные установщики находят Node, тянут bootstrap и регистрируют глобальный CLI, но неинтерактивные оболочки и корпоративный TLS могут остановить «успех» на скачивании: бинарник лежит в пользовательском префиксе, а сервисные учётки CI его не видят; или npm-global установился, но не-login shell пропускает rc, меняющие PATH. Шесть типичных неверных прочтений ниже.
node -v с официальной таблицей требований, а не с тем, что «npm работает».which openclaw может указывать на разные префиксы—всегда печатать разрешённый путь до отладки конфигурации.HTTPS_PROXY, npm config set cafile или внутреннее зеркало registry после security-review.@latest; поведение Gateway уезжает за ночь—часто коррелирует с кейсами «каналы выглядят здоровыми» в статье триажа Gateway без ответа.Выбор ветки привязывать к топологии из гайда на три платформы: интерактивная разработка может предпочесть быстрый скрипт; безлюдные билдеры — npm, дружественный к pin, или внутренние артефакты с версиями Node и CLI в тикете изменения.
Если стандарт pnpm/corepack, правило то же: только аудируемые точки входа, Environment systemd/launchd как в интерактивных shell. Документировать миграции, когда публичные доки ещё говорят latest, а базовая линия pin-ит semver.
Если на хосте несколько Node-проектов, изолировать мажор рантайма OpenClaw от рантаймов приложений, чтобы апгрейды не каскадировали—тот же изоляционный подход, что в статьях о пулах, применённый к Node.
Оценивать доступность хостов скриптов, потребность в аудите и безлюдную эксплуатацию—не вкусовщину.
| Измерение | Ветка curl/bash или PowerShell | Ветка npm / pnpm global |
|---|---|---|
| Скорость первой установки | Обычно меньше всего шагов при чистом интернете | Сначала нужны готовые Node и менеджер пакетов |
| Соответствие корпоративному прокси | Зависит от доменов скриптов и цепочек сертификатов; шумные сбои | Делит registry, cafile, strict-ssl и pins—удобно для аудита |
| Повторяемость | Теги latest дрейфуют как неуправляемый npm | Явный [email protected] можно зеркалить во внутренних lockfile |
| Без присмотра / CI | Нужны неинтерактивные гарантии и контракты PATH | Проще запечь в golden images или базовые контейнеры |
| Откат | Зависит от семантики деинсталлятора | Переустановить предыдущий semver с документированным порядком удаления |
Вставлять вывод в тикеты или wiki; на удалённых Mac запускать в том же контексте логина, что и будущий демон.
node -v command -v openclaw openclaw --version 2>/dev/null || openclaw version 2>/dev/null || true # пример ветки npm (semver заменить на вашу базовую линию) # npm install -g [email protected] # npm config get registry # npm config get cafile
Предупреждение: не вставлять внутренние секреты .npmrc в публичные репозитории; в документации — плейсхолдеры, учётные данные — в secret manager.
cafile, затем npm install -g openclaw@<pin>; подтвердить одну версию через npm ls -g --depth=0.Environment systemd/launchd или окружение раннера—not только интерактивные rc.Для Ansible/Salt сделать задачи установки идемпотентными: повторные прогоны не должны тихо уезжать на latest. На Windows-парках описать execution policy и пути npm global в заметках GPO и пилотных OU до fleet-wide.
openclaw doctor: растяжение обычно сигнализирует PATH, права или прокси—not ручки модели.Полевая заметка (не бенчмарк): в корпоративных раскатах 2025–2026 «ветка скрипта без pins» чаще порождает ночные дрейф-тикеты на десятках хостов, чем «ветка npm + явные pins + окна изменений»; разрыв в повторяемости, не в пиковом CPU.
Если OpenClaw делит удалённый Mac с iOS-сборками, сдвигать апгрейды Node/OpenClaw от крупных скачков Xcode минимум на один цикл обслуживания, чтобы бисект оставался полезным.
На read-only-билдерах прикреплять трёхстрочный отпечаток к сводкам job (секреты редактировать) и сравнивать с метками времени старта Gateway; если отпечатки стабильны, а поведение меняется, предпочитать квоты модели или конфиг каналов петлям переустановки—это операционализирует четырёхуровневое разделение из статьи без ответа.
Интерактивные машины терпят проб и ошибок; продакшену нужны аудируемые ветки, pin версий и контракты PATH под демоны. Эфемерные облачные хосты, вечно тянущие @latest, возвращают триаж к угадыванию upstream-релизов. Командам, которым нужен предсказуемый egress, диск и логирование Gateway на удалённых Mac, чаще подходит выделенный Apple Silicon с гибкими условиями аренды, чем постоянно вращаемые одноразовые ВМ. MACCOME предлагает мультирегиональные Mac mini M4 / M4 Pro с публичными тарифами, чтобы базовые линии OpenClaw следовали той же региональной стратегии, что и билдеры.
Пилот на одном хосте с этим runbook до горизонтального масштабирования; согласовать отпечатки сбоев с деревом триажа без ответа, чтобы срезать дублирующую работу.
Ежеквартально пересматривать allowlist доменов установщика и npm-registry—дешевле ретроспективной прокси-археологии в чате.
Привязать этот runbook к внутреннему шаблону изменений, чтобы новые кластеры по умолчанию наследовали pins и PATH.
FAQ
Граница с гайдом на три платформы?
Гайд покрывает сценарии и пути; эта статья — две ветки, прокси-фолбэк и pins. Контекст цен: тарифы аренды.
Можно ли пропустить локальную установку и использовать только Docker?
Да, но на хостах всё равно нужны согласованные CLI и права на тома—см. продакшен-runbook Docker. Статья по-прежнему объясняет, откуда на хосте берутся версии Node и CLI.
Отличия WSL2 и нативного Linux?
Различаются наличие systemd, маппинг путей и унаследованные Windows-прокси; при сбоях предпочтительнее npm внутри WSL со своими прокси и cafile.