Überschreibungen für die Plugin-Installation

Plugin-Installationsüberschreibungen ermöglichen es Maintainern, Plugin-Installationen während der Einrichtung auf ein bestimmtes npm-Paket oder lokales npm-Pack-Tarball statt auf die Katalog-, gebündelte oder standardmäßige npm-Quelle zu verweisen. Sie sind ausschließlich für E2E und Paketvalidierung vorgesehen; normale Benutzer installieren Plugins mit openclaw plugins install.

Umgebung

Überschreibungen sind deaktiviert, sofern nicht beide Variablen gesetzt sind:

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

Die Überschreibungszuordnung ist JSON, das nach Plugin-ID verschlüsselt ist. Die Werte unterstützen:

Verhalten

Wenn ein Einrichtungsablauf ein Plugin installiert, dessen ID in der Zuordnung enthalten ist, verwendet OpenClaw die Überschreibungsquelle anstelle der Katalog-, gebündelten oder standardmäßigen npm- Quelle. Dies gilt für das Onboarding und alle anderen Abläufe, die das gemeinsam genutzte Plugin-Installationsprogramm für die Einrichtung verwenden.

• Überschreibungen erzwingen weiterhin die erwartete Plugin-ID: Ein codex zugeordnetes Tarball muss ein Plugin installieren, dessen Manifest-ID codex lautet.
• Überschreibungen übernehmen nicht den offiziellen Status als vertrauenswürdige Quelle. Selbst wenn der Katalogeintrag normalerweise ein OpenClaw-eigenes Paket darstellt, wird eine Überschreibung als vom Betreiber bereitgestellte Testeingabe behandelt.
• Workspace-.env-Dateien können Installationsüberschreibungen nicht aktivieren; beide Umgebungsvariablen befinden sich auf der Sperrliste für Workspace-dotenv-Dateien. Legen Sie sie in der vertrauenswürdigen Shell, im CI-Job oder im Remote-Testbefehl fest, der OpenClaw startet.

Paket-E2E

Verwenden Sie ein isoliertes Zustandsverzeichnis, damit Paketinstallationen und Installationsdatensätze nicht Ihren normalen OpenClaw-Zustand verändern:

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

Überprüfen Sie das installierte Paket im Zustandsverzeichnis:

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

Beziehen Sie für Live-Provider-E2E den echten API-Schlüssel aus einer vertrauenswürdigen Shell oder einem CI- Secret, bevor Sie den Testbefehl starten. Geben Sie keine Schlüssel aus; melden Sie nur die Quelle und ob der Schlüssel vorhanden war.