---
read_when:
    - Test dei flussi di avvio guidato o di configurazione con un Plugin impacchettato localmente
    - Verifica di un pacchetto Plugin prima della pubblicazione
    - Sostituzione di un'installazione automatica di plugin con un artefatto di test
sidebarTitle: Install overrides
summary: Testare gli override dei plugin pacchettizzati con flussi di installazione in fase di configurazione
title: Override di installazione dei Plugin
x-i18n:
    generated_at: "2026-05-10T19:43:51Z"
    model: gpt-5.5
    provider: openai
    source_hash: f0fca17c1c78b11a87a1ec265510d9bc5aa9826822f4888e37ff1b3f3803598e
    source_path: plugins/install-overrides.md
    workflow: 16
---

Gli override di installazione dei Plugin consentono ai maintainer di testare le installazioni dei Plugin al momento della configurazione rispetto a
uno specifico pacchetto npm o a un tarball locale prodotto con npm-pack. Sono destinati solo alla
validazione E2E e dei pacchetti. Gli utenti normali dovrebbero installare i Plugin con
[`openclaw plugins install`](/it/cli/plugins).

<Warning>
Gli override eseguono il codice del Plugin dalla sorgente fornita. Usali solo in una
directory di stato isolata o su una macchina di test usa e getta.
</Warning>

## Ambiente

Gli override sono disabilitati a meno che entrambe le variabili siano impostate:

```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"
}'
```

La mappa degli override è JSON indicizzato per id del Plugin. I valori supportano:

- `npm:<registry-spec>` per pacchetti di registro e versioni esatte o tag
- `npm-pack:<path.tgz>` per tarball locali prodotti da `npm pack`

I percorsi relativi `npm-pack:` vengono risolti dalla directory di lavoro corrente.

## Comportamento

Quando un flusso al momento della configurazione richiede di installare un Plugin il cui id compare nella mappa,
OpenClaw usa la sorgente di override invece della sorgente npm da catalogo, inclusa nel bundle o predefinita.
Questo si applica all'onboarding e ad altri flussi che usano il programma condiviso di installazione dei Plugin
al momento della configurazione.

Gli override applicano comunque l'id del Plugin previsto. Un tarball mappato a `codex`
deve installare un Plugin il cui id nel manifest è `codex`.

Gli override non ereditano lo stato ufficiale di sorgente attendibile. Anche quando la voce del catalogo
rappresenta normalmente un pacchetto di proprietà di OpenClaw, un override viene trattato come
input di test fornito dall'operatore.

I file `.env` del workspace non possono abilitare gli override di installazione. Imposta queste variabili nella
shell attendibile, nel job CI o nel comando di test remoto che avvia OpenClaw.

## E2E pacchetto

Usa una directory di stato isolata in modo che le installazioni dei pacchetti e i record di installazione non
tocchino il tuo normale stato di 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
```

Verifica il pacchetto installato nella directory di stato:

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

Per E2E con provider live, carica la chiave API reale da una shell attendibile o da un segreto CI
prima di avviare il comando di test. Non stampare le chiavi; riporta solo la sorgente e
se la chiave era presente.