Перевизначення встановлення Plugin

Перевизначення встановлення плагінів дають змогу супровідникам тестувати встановлення плагінів під час налаштування з певним пакетом npm або локальним tar-архівом, створеним npm-pack. Вони призначені лише для E2E та перевірки пакетів. Звичайним користувачам слід встановлювати плагіни за допомогою openclaw plugins install.

# Середовище

Перевизначення вимкнені, якщо не задано обидві змінні:

export OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1
export OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{
  "codex": "npm-pack:/tmp/openclaw-codex-2026.5.8.tgz",
  "openclaw-web-search": "npm:@openclaw/web-search@2026.5.8"
}'

Мапа перевизначень є JSON з ключами за ідентифікатором плагіна. Значення підтримують:

• npm:<registry-spec> для пакетів реєстру та точних версій або тегів
• npm-pack:<path.tgz> для локальних tar-архівів, створених npm pack

Відносні шляхи npm-pack: розв'язуються відносно поточного робочого каталогу.

# Поведінка

Коли потік під час налаштування запитує встановлення плагіна, ідентифікатор якого є в мапі, OpenClaw використовує джерело перевизначення замість джерела з каталогу, вбудованого або типового джерела npm. Це застосовується до онбордингу та інших потоків, які використовують спільний інсталятор плагінів під час налаштування.

Перевизначення все одно примусово перевіряють очікуваний ідентифікатор плагіна. Tar-архів, зіставлений із codex, має встановлювати плагін, чий ідентифікатор у маніфесті — codex.

Перевизначення не успадковують офіційний статус довіреного джерела. Навіть коли запис каталогу зазвичай представляє пакет, що належить OpenClaw, перевизначення розглядається як тестовий вхід, наданий оператором.

Файли .env у робочому просторі не можуть увімкнути перевизначення встановлення. Задавайте ці змінні в довіреній оболонці, завданні CI або віддаленій тестовій команді, яка запускає OpenClaw.

# E2E пакетів

Використовуйте ізольований каталог стану, щоб встановлення пакетів і записи про встановлення не зачіпали ваш звичайний стан OpenClaw:

npm pack extensions/codex --pack-destination /tmp

OPENCLAW_STATE_DIR="$(mktemp -d)" \
OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1 \
OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{"codex":"npm-pack:/tmp/openclaw-codex-2026.5.8.tgz"}' \
pnpm openclaw onboard --mode local

Перевірте встановлений пакет у каталозі стану:

find "$OPENCLAW_STATE_DIR/npm/node_modules" -maxdepth 3 -name package.json -print
grep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/package-lock.json"

Для E2E із live-провайдером завантажте справжній API-ключ із довіреної оболонки або секрету CI перед запуском тестової команди. Не друкуйте ключі; повідомляйте лише джерело та чи був ключ наявний.