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