`openclaw plugins`

Verwalte Gateway-Plugins/Erweiterungen (im Prozess geladen).

Verwandte Themen:

Plugin-System: Plugins
Plugin-Manifest + Schema: Plugin manifest
Sicherheitshärtung: Security

Befehle

openclaw plugins list
openclaw plugins info <id>
openclaw plugins enable <id>
openclaw plugins disable <id>
openclaw plugins uninstall <id>
openclaw plugins doctor
openclaw plugins update <id>
openclaw plugins update --all

Mitgelieferte Plugins werden mit OpenClaw ausgeliefert, starten aber deaktiviert. Verwende plugins enable, um sie zu aktivieren.

Alle Plugins müssen eine openclaw.plugin.json-Datei mit einem eingebetteten JSON-Schema (configSchema, auch wenn leer) enthalten. Fehlende/ungültige Manifeste oder Schemas verhindern das Laden des Plugins und lassen die Konfigurationsvalidierung fehlschlagen.

Install

openclaw plugins install <path-or-spec>
openclaw plugins install <npm-spec> --pin

Sicherheitshinweis: Behandle Plugin-Installationen wie das Ausführen von Code. Bevorzuge gepinnte Versionen.

Npm-Spezifikationen sind nur für die Registry (Paketname + optionale exakte Version oder dist-tag). Git/URL/Datei-Spezifikationen und Semver-Bereiche werden abgelehnt. Abhängigkeits-Installationen laufen mit --ignore-scripts zur Sicherheit.

Einfache Spezifikationen und @latest bleiben auf dem Stable-Track. Wenn npm eine davon als Prerelease auflöst, stoppt OpenClaw und fordert dich auf, explizit mit einem Prerelease-Tag wie @beta/@rc oder einer exakten Prerelease-Version wie @1.2.3-beta.4 zuzustimmen.

Wenn eine einfache Install-Spezifikation einer gebündelten Plugin-ID entspricht (zum Beispiel diffs), installiert OpenClaw das gebündelte Plugin direkt. Um ein npm-Paket mit demselben Namen zu installieren, verwende eine explizite Scope-Spezifikation (zum Beispiel @scope/diffs).

Unterstützte Archive: .zip, .tgz, .tar.gz, .tar.

Verwende --link, um das Kopieren eines lokalen Verzeichnisses zu vermeiden (fügt zu plugins.load.paths hinzu):

openclaw plugins install -l ./my-plugin

Verwende --pin bei npm-Installationen, um die aufgelöste exakte Spezifikation (name@version) in plugins.installs zu speichern, während das Standardverhalten ungepinnt bleibt.

Uninstall

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 und verknüpften plugins.load.paths-Einträgen, wenn zutreffend. Für aktive Memory-Plugins wird der Memory-Slot auf memory-core zurückgesetzt.

Standardmäßig entfernt die Deinstallation auch das Plugin-Installationsverzeichnis unter dem aktiven State-Dir-Erweiterungsstamm ($OPENCLAW_STATE_DIR/extensions/<id>). Verwende --keep-files, um die Dateien auf der Festplatte zu behalten.

--keep-config wird als veralteter Alias für --keep-files unterstützt.

Update

openclaw plugins update <id>
openclaw plugins update --all
openclaw plugins update <id> --dry-run

Updates gelten nur für Plugins, die über npm installiert wurden (erfasst in plugins.installs).

Wenn ein gespeicherter Integritäts-Hash existiert und sich der Hash des heruntergeladenen Artefakts ändert, gibt OpenClaw eine Warnung aus und bittet um Bestätigung, bevor es fortfährt. Verwende das globale --yes, um Eingabeaufforderungen in CI/nicht-interaktiven Läufen zu umgehen.