Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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