> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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, ключами якого є ідентифікатори Plugin. Значення підтримують:

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

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

## Поведінка

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

Перевизначення все одно примусово перевіряють очікуваний ідентифікатор Plugin. Tarball, зіставлений із `codex`,
має встановити Plugin, чий ідентифікатор у маніфесті дорівнює `codex`.

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

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

## E2E пакунка

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
find "$OPENCLAW_STATE_DIR/npm/projects" -path '*/node_modules/@openclaw/codex/package.json' -print
grep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/projects"/*/package-lock.json
```

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