---
read_when:
    - Тестування потоків онбордингу або налаштування з локально запакованим Plugin
    - Перевірка пакета Plugin перед публікацією
    - Заміна автоматичного встановлення Plugin тестовим артефактом
sidebarTitle: Install overrides
summary: Перевірте перевизначення упакованих плагінів за допомогою потоків встановлення під час налаштування
title: Перевизначення встановлення Plugin
x-i18n:
    generated_at: "2026-05-11T20:48:02Z"
    model: gpt-5.5
    provider: openai
    source_hash: f0fca17c1c78b11a87a1ec265510d9bc5aa9826822f4888e37ff1b3f3803598e
    source_path: plugins/install-overrides.md
    workflow: 16
---

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

<Warning>
Перевизначення виконують код плагіна з наданого вами джерела. Використовуйте їх лише в
ізольованому каталозі стану або на одноразовій тестовій машині.
</Warning>

## Середовище

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

```bash
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:

```bash
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
```

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

```bash
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
перед запуском тестової команди. Не друкуйте ключі; повідомляйте лише джерело та
чи був ключ наявний.