Переопределения установки плагинов позволяют сопровождающим направлять выполняемую во время настройки установку плагинов на
определённый пакет npm или локальный tarball-пакет npm вместо источника из каталога,
встроенного источника или источника npm по умолчанию. Они предназначены только для E2E и проверки пакетов;
обычные пользователи устанавливают плагины с помощью
openclaw plugins install.
Переопределения выполняют код плагина из указанного вами источника. Используйте их только
в изолированном каталоге состояния или на одноразовой тестовой машине.
Переменные окружения
Переопределения отключены, если не заданы обе переменные:
Карта переопределений представлена в формате JSON, где ключами служат идентификаторы плагинов. Значения поддерживают:
Поведение
Когда поток, выполняемый во время настройки, устанавливает плагин, идентификатор которого присутствует в карте, OpenClaw
использует переопределённый источник вместо каталога, встроенного или стандартного источника npm.
Это относится к первоначальной настройке и любому другому потоку, использующему общий
установщик плагинов во время настройки.
- Переопределения по-прежнему требуют ожидаемый идентификатор плагина: tarball, сопоставленный с
codex,
должен устанавливать плагин, идентификатор которого в манифесте — codex.
- Переопределения не наследуют статус официального доверенного источника. Даже если
запись каталога обычно представляет пакет, принадлежащий OpenClaw, переопределение
считается тестовыми входными данными, предоставленными оператором.
- Файлы
.env рабочей области не могут включать переопределения установки; обе переменные среды входят
в список заблокированных переменных dotenv рабочей области. Задайте их в доверенной оболочке, задании CI или
удалённой тестовой команде, запускающей OpenClaw.
Сквозное тестирование пакета
Используйте изолированный каталог состояния, чтобы установка пакетов и записи об установке не
затрагивали обычное состояние OpenClaw:
Проверьте установленный пакет в каталоге состояния:
Для сквозного тестирования реального провайдера получите настоящий ключ API из доверенной оболочки или секрета
CI перед запуском тестовой команды. Не выводите ключи; сообщайте только
источник и наличие ключа. 