Сингапур, Япония, Корея, Гонконг, Восток США, Запад СШАголый металлМак мини М4 ПровOpenClawя бегуПосле 2 мая 2026 г.После релизаШлюз не запускается из-за отсутствия внешнего плагина npm install -g @openclaw/discordДаже после этогоотсутствует плагинЕсли это остается, причина не в ключе модели.Корень установки плагина является глобальным npm~/.openclaw/npmОн был перенесен вНастройки часто указывают на старые пути. Текст4.x / ранняя версия 5.xДля оперативного персонала изМатрица решений по пути установки, Контрольный список из 10 шагов реализации, openclaw doctor --fix / --lint / --non-interactiveприменимые границы,OPENCLAW_PLUGIN_STAGE_DIRКак поделиться на удаленном Mac. ЦенаСтраница цен, порядокстраница заказа, удаленный доступ естьцентр обслуживания клиентовОн основан на .пост о первом запуске, статья об обновлении npm, Пост проверки работоспособности 2026.5.xРекомендуем читать вместе с .
После прочтения вы можете решить следующее: ① Плагинглобальный НПМДолжен ли я положить это~/.openclaw/npm/node_modulesВставьте его. ② Когда шлюз уже вышел из строяоффлайн заказКак сначала заполнить пакет, а потом бежать к врачу. ③ Просмотр этапов плагина, журналов и выходных данных модели на удаленном компьютере Mac емкостью 256–512 ГБ.На какой том поместить. Подкоманды CLI и соглашения о каталогахОфициальная документация OpenClaw и примечания к выпуску GitHubПожалуйста, проверьте ссылку еще раз после развертывания.
[SECTION_01] // PLUGIN_FAILURE Пять основных причин, почему шлюз не открывается после обновления до 2026.5.x из-за внешних плагинов
Во-первых, этоНесоответствие места установкинет, смотри. В окне обслуживанияnpm install -gЗапускайте шлюз в качестве манифеста только после 2026.5.2.~/.openclaw/npm/node_modulesЕсли вы только сканируете, в журнале появляется настроенный плагин не найден, но команда ищет только глобальные node_modules. Во-вторых, этоНесоответствие имени пакета и ключа конфигурациинет, смотри. Область применения, такая как Discord·Voice и т. д.openclaw.jsonЕсли он отличается от идентификатора, врач показывает устаревшую установку, но вы не можете нажать «Исправить», опасаясь удаления производственного канала.
ТретийКруговая зависимость врача и шлюзанет, смотри. Когда Шлюз отказывается запускаться из-за отсутствия плагинаopenclaw gateway restartПросто повтори,openclaw doctor --fixя на правильном путиnpm installЧто делать, так это холостой ход. Если вы запустите неинтерактивное исправление на удаленном Mac без резервной копии конфигурации, плагин «только для разрешений» будет отсутствовать в манифесте, и cron Dawn автоматически завершится сбоем. Четвертое - этоконфликт за дискнет, смотри. Если вы разместите сцену, кэш pnpm и журнал шлюза на системном томе модели емкостью 256 ГБ,npm installУстановка прошла успешно, поскольку пиковые снимки и снимки APFS перекрываются, но это похоже на тайм-аут шлюза. ПятоеПолурепликация между узламинет, смотри. В А~/.openclawПросто rsync иnpmЗа исключением поддерева, в B есть только настройки и нет пакетов.
- Дрейф пути:с глобальным npm
~/.openclaw/npmДвойная система, никаких настроек. - Имя пакета неоднозначно:Несоответствие объема и настроек Brave, Discord, Voice и т. д.
- Неправильный порядок восстановления:Перезапустите шлюз перед установкой пакета.
- Неинтерактивное исправление побочных эффектов:
doctor --fixУдалите запись «только разрешить». - Уровень диска:Сигнализация емкости на той же громкости, что и сцена и журнал.
- Предыдущая половина:Просто синхронизируйте настройки
npmОтсутствует подкаталог.
Суть проблем с внешними плагинами заключается вВсе идентификаторы, введенные в конфигурацию, интерпретируются как фактические пакеты в одном обещанном каталоге., и это не означает повторной установки глобального CLI.
[ SECTION_02 ] // PATH_MATRIX Глобальный npm, ~/.openclaw/npm, ClawHub: матрица выбора пути установки
Версия 2026.5.x переводит плагины каналов/расширений в режим npm-first и сокращает количество проверок холодного запуска шлюза с помощью метаданных манифеста. В Runbook сначалаединый авторитетный каталогПосле исправления исправьте версию.
| аспект | A · глобальный npm (-g) | B · ~/.openclaw/npm (рекомендуется по умолчанию) | C · ClawHub / Встроенные каналы |
|---|---|---|---|
| Ситуация с применением | Только тело CLI, тестирование, переход на документацию 4.x | 2026.5.2+ Производственный шлюз, многоканальный | Официальное встроенное или закрепленное на ClawHub расширение. |
| Видимость шлюза | Во многих случаях установка возможна, но сканирование невозможно. | В соответствии с логикой восстановления врача | Согласно манифесту/переключателю канала |
| Сложность отката | В центре: объединение глобальных параметров и настроек вместе. | низость:npmСнимок tar поддерева |
От низкого до среднего: вернуть версию для каждого идентификатора плагина. |
| удаленный Mac-диск | системный том глобальный node_modules | Отдельный том возможен в сочетании с STAGE_DIR. | Кэш увеличивается пропорционально количеству плагинов |
Статья о нескольких рабочих пространствахЕсли вы исправили версию ClawHub, вы также можете использовать внешние плагины npm.Регистрация в реестре на основе рабочей областиЭто гарантирует, что обновления Discord проекта A не перезапишут общий каталог B.
[ SECTION_03 ] // DOCTOR_STAGE режим восстановления openclaw Doctor и разделение слоев OPENCLAW_PLUGIN_STAGE_DIR
Официальный врач доступен только для чтения--lintс автоматическим восстановлением--fixобеспечивает. В окне изменений сначала используйте lint, чтобы оставить ссылки на отсутствующие пакеты, устаревшую установку и отсутствующие каталоги в виде текста, а затем примените исправление в слоте обслуживания. Если шлюз уже отключенБез запуска шлюзаскудный@openclaw/*를 ~/.openclaw/npmБезопаснее поставить его, а потом починить. В переходный период 2026.5.2 он ставился глобально, но во многих случаях путь сканирования отличается, поэтому исправление после ручного дополнения часто короче цикла перезапуска.
OPENCLAW_PLUGIN_STAGE_DIRразделяет корень распаковки и корень загрузки при запуске. Обычной конфигурацией для удаленных компьютеров Mac является наличие рабочей области на диске данных и горячего пути на внутреннем SSD. После выпуска проверьте еще раз, наследует ли файл launchd plist переменные среды.
Ниже приводится официальный врач OpenClaw и информация о выпуске. Повторно откройте ссылку после обновления исходного репозитория.
https://docs.openclaw.ai/gateway/doctor
https://github.com/openclaw/openclaw/releases
openclaw Doctor --lint > /tmp/oc-doctor-lint.txt
cd ~/.openclaw/npm && npm install @openclaw/discord@<закреплено>
экспортировать OPENCLAW_PLUGIN_STAGE_DIR="/Volumes/data/openclaw-stage"
доктор openclaw --fix --неинтерактивный
статус шлюза openclaw
[ SECTION_04 ] // RUNBOOK Завершена миграция внешнего плагина 4.x → 2026.5.x за 10 шагов (возможно воспроизведение на удаленном Mac).
- Исправлен реестр плагина:Зарегистрируйте активный идентификатор, версию и зависимости канала в заявке на изменение.
- Полная резервная копия:
~/.openclaw(npmсвяжите файл launchd plist иopenclaw --versionЯ оставляю это. - Обновление тела CLI:Мы поднимаем OpenClaw согласно примечаниям к выпуску и не пропускаем примечания к переходу на промежуточную версию.
- Создайте корень npm:
~/.openclaw/npm/package.jsonи не размещайте пакет только глобально. - Установка как Тэджангдаэро:Каждый внешний плагин имеет версию
~/.openclaw/npmи сначала установите разрешение только. - Настройки STAGE_DIR:Для 512 ГБ и более в качестве сцены устанавливается несистемный том. 256 ГБ обеспечивает как минимум 20 ГБ для плагинов и кеша.
- ворс, а затем исправить:
doctor --lintКогда нет настроенного, но отсутствует--fixделать. - Проверка шлюза:
openclaw gateway statusи зонд 18789пост проверки здоровьяКонтраст с. - Канал дыма:Отправьте тестовое сообщение на каждый активный канал, чтобы записать задержку и путь журнала.
- Отражение Runbook:Окончательное дерево каталогов, замороженная версия и путь к tar-файлу отката регистрируются в вики и проверяются ежеквартально.
Пример небольшой команды (анонимно):команда из 3 человекТокийский регионПри обновлении с 2026.4.27 → 2026.5.4 на M4 Pro ШлюзdiscordЗаявил об упущении и уволен.npm iНо снова и снова это не получалось. в текстовом порядке~/.openclaw/npmВставьте пакет и поместите STAGE как расширенный том.doctor --fixпрошел за один раз, сократив ожидаемую 90-минутную остановку до 28 минут.
[ SECTION_05 ] // ДАННЫЕ_Часто задаваемые вопросы Цитируемая техническая информация, дисковые бюджеты и часто задаваемые вопросы
Цифры нижеРазделы, часто используемые при планировании мощностии не является фактическим измерением. Пожалуйста, отдавайте приоритет официальной документации после выпуска.
- Корень плагина:2026.5.2+ Производство есть
~/.openclaw/npm/node_modulesСделайте это подлинной копиейnpm root -gНе смешивайте с . - Бюджет диска:Удаленный Mac емкостью 256 ГБ имеет ≥20 ГБ кэша stage·npm. Несколько рабочих областей и большие журналыРасширение 1 ТБ/2 ТБОбзор .
- Режим врача:
--lintдоступен только для чтения перед CI/изменением,--non-interactiveэто автоматическое обслуживание,--deepЭто необходимо для очистки оставшихся дубликатов установок. - Лицо релиза:2026.5.3~5.4 усиливает инструмент передачи файлов и отложенную загрузку шлюза, поэтому чем больше плагинов, тем больше преимуществ от разделения кэша манифеста и иерархии каталогов.
ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ:
- Вопрос: Могу ли я продолжать использовать глобальные пакеты npm?О: Это не рекомендуется использовать в качестве производственного значения по умолчанию.
~/.openclaw/npmЕсли вы не измените настройки, он может не сканироваться даже после обновления. - Вопрос: Могу ли я запустить доктора, даже если шлюз выйдет из строя?А: Да. Doctor не полагается на режим ожидания шлюза, но вы можете уменьшить количество ошибок при удалении записей, вручную добавляя отсутствующие пакеты перед их исправлением.
- Вопрос: Каковы должности и роли обновления?А:обновить постCLI·LaunchAgent, основной текстВнешний плагин npm/перенос путинет, смотри.
- Вопрос: Как мне выбрать 6 регионов?О: Достаточно установить плагин и шлюз на один хост. Если вы реагируете на сбои за границей, разместите основную операцию в регионе, ближайшем к наиболее часто работающему участнику.
Расширяя альтернативу, вы даже можете протестировать плагин только на ноутбуке.Переменная среды launchd на удаленном «голом железе»не проверено. Если вы разместите каталог плагина на нерасширяемом системном томе,повторяющиеся обновления npmпределы мощности достигаются раньше. На офисных компьютерах Mac сложно изменить регионы или добавить хранилище во время периодов обслуживания.Внешний плагин OpenClaw 2026.5.x과 iOS CI, AI-агентЗапускаем его в производствоdoctor와 ~/.openclaw/npmпутьВозможен аудит и откатДля команд, которые хотят сохранитьАренда облака NOVAKVM Mac mini обычно является лучшим выбором.нет, смотри. Выделенный Apple Silicon, 6-региональный «голый металл» и ежедневная/еженедельная проверка аренды можно шаг за шагом модернизировать до высоких характеристик M4 Pro и расширения хранилища, что позволяет легко сопоставить местоположение упаковки и стабильность машины в одном билете на замену. Перед следующим незначительным обновлением проконсультируйтесь с менеджером плагинов.npmПоместите поддерево в резервную копию. Лучше уснуть, чем сомневаться в местонахождении посылки на рассвете.