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.
Überschreibungen führen Plugin-Code aus der von Ihnen angegebenen Quelle aus. Verwenden Sie sie nur in einem
isolierten Zustandsverzeichnis oder auf einer temporären Testmaschine.
Umgebung
Überschreibungen sind deaktiviert, sofern nicht beide Variablen gesetzt sind:
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:
Überprüfen Sie das installierte Paket im Zustandsverzeichnis:
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. 