В 2026 году многие операторы OpenClaw по привычке начинают сnpm install -g— и замирают наsharp: нативный стек обработки изображений, который тянет libvips. На ноутбуке разработчика проблему маскирует кэш бинарников; на свежихMac mini M4в облаке вСингапуре, Токио, Сеуле, Гонконге, на востоке и западе СШАэто становится воротами онбординга. Ниже — когда имеет смыслSHARP_IGNORE_GLOBAL_LIBVIPS, как выбрать между официальнымinstall.sh,install-cli.shи аккуратным префиксом npm без смешения каналов, и как закрыть цикл одним листом приёмкиopenclaw doctorдо масштабирования шлюзов по регионам.
1. Почему npm global кажется «зависшим» на sharp
sharpпоставляет пребилды под типичные связки macOS и Node, но шаг postinstall всё равно выбирает стратегию: скачать подходящий архив или собрать из исходников. Медленный путь включается придросселировании исходящего HTTPS, когда подобранный ABI не совпадает ни с одним опубликованным артефактом, или когда на хосте уже стоитHomebrew libvipsи sharp предпочитает линковку к системным заголовкам — тогда начинается долгая компиляция. В неинтерактивной SSH-сессии видно лишь тишину до успеха или стены ошибок компилятора. Относитесь к «зависанию» как к занятости: проверьте CPU черезtop, убедитесь, что исходящий HTTPS разрешён, и в автоматизации держитеnpm_config_loglevel=verbose, чтобы падать быстро, а не ждать таймаута вслепую.
На Apple Silicon в облаке отдельно проверьте случайныйNode x86_64 под Rosetta: селектор пребилдов sharp завязан на архитектуру, поэтому выровняйтеnode -p process.archс эталонным образом до обвинений sharp. Если прокси ломает TLS, поправьте доверенные корни заранее — иначе загрузки будут повторяться до срабатывания таймаута пайплайна.
2. SHARP_IGNORE_GLOBAL_LIBVIPS: когда переменная реально помогает
Если на общем образе когда-то выполнялиbrew install vips, sharp может попытаться привязаться к этому дереву. На время установкиSHARP_IGNORE_GLOBAL_LIBVIPS=1заставляет sharpигнорировать глобально обнаруженный libvipsи вернуться к vendored-маршруту — часто это разница между минутами компиляции и быстрым распакованием. Экспортируйте её в том же профиле оболочки, который видит ваш CI-пользователь при неинтерактивном SSH, а не только в интерактивном zsh. После успешной установки зафиксируйте, оставляете ли переменную на runtime; часть команд снимает её, когда корректный бинарник уже на диске, чтобы не маскировать будущие ошибки упаковки.
3. install.sh против install-cli.sh против npm-префикса: один «позвоночник» на когорту
Апстрим обычно даёт полныйinstall.shс поддерживаемым расположением файлов и более узкийinstall-cli.sh, когда на машине уже вылизан базовый стек. Оба удобны, если глобалы npm конфликтуют с политикой безопасности. Напротив, явный глобальный npm подвыделенным префиксом, принадлежащим сервисному пользователю, укладывает обновления в вашу semver-политику. Антипаттерн —двойной маршрут: половина флота через скрипт в/usr/local, половина черезnpm prefix=$HOME/.openclaw-npm, а launchd наследует тотPATH, который оказался уже́ при bootstrap. Выберите один канал на когорту, закодируйте в Terraform или золотом образе и не делайте «просто npm на этом одном хосте» в разгар инцидента. Матрицу install против npm и онбординг демона разберите вместе сПодробнее: безGUI-установка, onboard-демон и разбор через doctor; про маршрутизацию моделей после стабильной установки —Подробнее: несколько провайдеров и openclaw.json на облачном шлюзе.
4. Шесть метрополий — один зафиксированный профиль
Параллельные шлюзы вСингапуре, Токио, Сеуле, Гонконге, на востоке и западе СШАпревращают проблемы sharp в региональный шум, если каждый срез VM или bare-metal не делит один компиляторный стек, наличие Xcode CLT и одинаковый след Homebrew. Запеките дружественные к sharp настройки водин золотой образна уровень (например Mac mini M4 16 ГБ / 256 ГБ против 24 ГБ / 512 ГБ), снимите снапшот и продвигайте изменения пакетом. Оператор в Токио не должен гонять другой флаг sharp, чем когорта в Вирджинии. Если вы всё ещё считаете, на сколько недель арендовать железо перед обязательствами, сверьтесь сПодробнее: диск, параллельная сборка и поэтапное расширение в шести регионах, чтобы связать апгрейды RAM/NVMe с реальной конкуренцией компиляций.
5. openclaw doctor: одностраничный FAQ приёмки
После успешного sharp настоящие ворота — согласованы ли бинарники шлюза, пути конфигурации и сетевые проверки. Сразу выполнитеopenclaw doctor, сохраните stdout вместе с npm-логами (замаскируйте токены), добавьтеuname -aиnode -v, устраните TLS или смещение часов до повторного npm, чтобы не метаться между «sharp жив» и «шлюз не сопрягается».
Ниже — чек-лист для тикета изменения.
- В: doctor зелёный, но демон не слушает порт?Сравните
PATHвнутри launchd с интерактивной SSH-оболочкой; переустановите тем же позвоночником, что описан в регламенте. - В: sharp установился, а превью падают?Проверьте права сервисного пользователя на каталог кэша и что arm64-Node не смешан с Rosetta.
- В: пересборки sharp только в одном регионе?Сначала сравните манифесты brew и версии CLT — при замороженных образах зеркала не должны расходиться.
- В: держать SHARP_IGNORE_GLOBAL_LIBVIPS навсегда?Снимите после удаления лишнего brew vips, если политика не требует вечного игнора глобалов.
На облаке vpszap всё это проще
Головная боль sharp сильнее всего наизменяемых общих образах, где каждый инженер оставляет свой след Homebrew. vpszap даётфизические Mac mini M4—без виртуализации «кусочков», с предсказуемым диском, активациейпримерно за пять минути одновременной выдачейSSH и VNC, если политика требует посмотреть GUI-установщик. Оплата — задень, неделю, месяц или квартал, бездолгих контрактов; шесть глобальных метрополий позволяют поставить шлюзы рядом с операторами или апстрим-API без самодельных исключений по регионам.
Если нужна самая дружелюбная площадка, чтобы заморозить образ, дружественный OpenClaw, до прод-трафика,облачный Mac mini vpszapближе всего к владению стойками без владения стойками.
