Overschrijvingen voor Plugin-installatie

Overschrijvingen voor Plugin-installaties stellen beheerders in staat om Plugin-installaties tijdens de configuratie naar een specifiek npm-pakket of lokaal npm-pack-tarballbestand te verwijzen in plaats van naar de catalogus, gebundelde of standaard npm-bron. Ze zijn uitsluitend bedoeld voor E2E- en pakketvalidatie; normale gebruikers installeren plugins met openclaw plugins install.

Omgeving

Overschrijvingen zijn uitgeschakeld tenzij beide variabelen zijn ingesteld:

export OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1export OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{  "codex": "npm-pack:/tmp/openclaw-codex-2026.5.8.tgz",  "openclaw-web-search": "npm:@openclaw/web-search@2026.5.8"}'

De overschrijvingskaart is JSON met Plugin-id's als sleutels. Waarden ondersteunen:

Gedrag

Wanneer een configuratieproces een Plugin installeert waarvan de id in de kaart voorkomt, gebruikt OpenClaw de overschrijvingsbron in plaats van de catalogus, gebundelde of standaard npm-bron. Dit geldt voor onboarding en elk ander proces dat het gedeelde installatieprogramma voor plugins tijdens de configuratie gebruikt.

• Overschrijvingen blijven de verwachte Plugin-id afdwingen: een tarballbestand dat aan codex is toegewezen, moet een Plugin installeren waarvan de manifest-id codex is.
• Overschrijvingen nemen de officiële status van vertrouwde bron niet over. Zelfs wanneer de catalogusvermelding normaal gesproken een pakket van OpenClaw vertegenwoordigt, wordt een overschrijving behandeld als door de beheerder aangeleverde testinvoer.
• .env-bestanden in de werkruimte kunnen installatieoverschrijvingen niet inschakelen; beide omgevingsvariabelen staan op de lijst met geblokkeerde dotenv-variabelen voor de werkruimte. Stel ze in via de vertrouwde shell, CI-taak of externe testopdracht waarmee OpenClaw wordt gestart.

Pakket-E2E

Gebruik een geïsoleerde statusmap, zodat pakketinstallaties en installatierecords uw normale OpenClaw-status niet beïnvloeden:

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

Controleer het geïnstalleerde pakket in de statusmap:

find "$OPENCLAW_STATE_DIR/npm/projects" -path '*/node_modules/@openclaw/codex/package.json' -printgrep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/projects"/*/package-lock.json

Voor E2E met een actieve provider haalt u de echte API-sleutel uit een vertrouwde shell of een CI-geheim voordat u de testopdracht start. Druk sleutels niet af; vermeld alleen de bron en of de sleutel aanwezig was.