Skip to main content

openclaw plugins

Verwalten Sie Gateway-Plugins/-Erweiterungen (im Prozess geladen). Verwandt:

Befehle

Gebündelte Plugins werden mit OpenClaw ausgeliefert, starten jedoch deaktiviert. Verwenden Sie plugins enable, um sie zu aktivieren. Alle Plugins müssen eine Datei openclaw.plugin.json mit einem eingebetteten JSON-Schema (configSchema, auch wenn leer) enthalten. Fehlende/ungültige Manifeste oder Schemata verhindern das Laden des Plugins und lassen die Konfigurationsvalidierung fehlschlagen.

Installieren

Sicherheitshinweis: Behandeln Sie Plugin-Installationen wie das Ausführen von Code. Bevorzugen Sie gepinnte Versionen. Npm-Spezifikationen sind nur Registry-basiert (Paketname + optionale Version/Tag). Git/URL/File- Spezifikationen werden abgelehnt. Dependency-Installationen werden aus Sicherheitsgründen mit --ignore-scripts ausgeführt. Unterstützte Archive: .zip, .tgz, .tar.gz, .tar. Verwenden Sie --link, um das Kopieren eines lokalen Verzeichnisses zu vermeiden (fügt zu plugins.load.paths hinzu):

Deinstallation

uninstall entfernt Plugin-Einträge aus plugins.entries, plugins.installs, der Plugin-Allowlist sowie verknüpfte plugins.load.paths-Einträge, sofern zutreffend. Bei aktiven Memory-Plugins wird der Memory-Slot auf memory-core zurückgesetzt. Standardmäßig entfernt die Deinstallation außerdem das Plugin-Installationsverzeichnis im aktiven State-Dir-Extensions-Root ($OPENCLAW_STATE_DIR/extensions/<id>). Verwenden Sie --keep-files, um die Dateien auf der Festplatte zu behalten. --keep-config wird als veraltetes Alias für --keep-files unterstützt.

Aktualisieren

Aktualisierungen gelten nur für Plugins, die von npm installiert wurden (nachverfolgt in plugins.installs).