Zum Hauptinhalt springen

openclaw plugins

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

Befehle

openclaw plugins list
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins doctor
openclaw plugins update <id>
openclaw plugins update --all
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

openclaw plugins install <path-or-spec>
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):
openclaw plugins install -l ./my-plugin

Deinstallation

openclaw plugins uninstall <id>
openclaw plugins uninstall <id> --dry-run
openclaw plugins uninstall <id> --keep-files>
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

openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update <id> --dry-run
Aktualisierungen gelten nur für Plugins, die von npm installiert wurden (nachverfolgt in plugins.installs).