Gli override per l’installazione dei Plugin consentono ai manutentori di fare in modo che le installazioni dei Plugin durante la configurazione usino uno specifico pacchetto npm o un tarball locale creato con npm pack, anziché la fonte del catalogo, quella inclusa o quella npm predefinita. Sono disponibili esclusivamente per la convalida E2E e dei pacchetti; gli utenti normali installano i Plugin con
openclaw plugins install.
Gli override eseguono il codice del Plugin dalla fonte fornita. Usali solo in una directory di stato isolata o su una macchina di test temporanea.
Ambiente
Gli override sono disabilitati, a meno che non siano impostate entrambe le variabili:
La mappa degli override è un oggetto JSON le cui chiavi sono gli ID dei Plugin. I valori supportano:
Comportamento
Quando un flusso di configurazione installa un Plugin il cui ID è presente nella mappa, OpenClaw usa la fonte dell’override anziché la fonte del catalogo, quella inclusa o quella npm predefinita. Ciò si applica all’onboarding e a qualsiasi altro flusso che utilizzi il programma di installazione condiviso dei Plugin durante la configurazione.
- Gli override continuano a imporre l’ID del Plugin previsto: un tarball associato a
codex deve installare un Plugin il cui ID nel manifest sia codex.
- Gli override non ereditano lo stato di fonte ufficiale attendibile. Anche quando la voce del catalogo rappresenta normalmente un pacchetto appartenente a OpenClaw, un override viene trattato come input di test fornito dall’operatore.
- I file
.env dell’area di lavoro non possono abilitare gli override di installazione; entrambe le variabili di ambiente sono incluse nell’elenco dotenv bloccato per l’area di lavoro. Impostale nella shell attendibile, nel processo CI o nel comando di test remoto che avvia OpenClaw.
E2E del pacchetto
Usa una directory di stato isolata affinché le installazioni dei pacchetti e i relativi record non modifichino il normale stato di OpenClaw:
Verifica il pacchetto installato nella directory di stato:
Per l’E2E di un provider reale, 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; indica solo la fonte e se la chiave era presente. 