Plugins verwalten

Die Control UI deckt den üblichen Workflow zum Ermitteln, Installieren, Aktivieren und Deaktivieren ab. Die CLI ergänzt Aktualisierung, Deinstallation, erweiterte Konfiguration und explizite Steuerelemente für Installationsquellen. Den vollständigen Befehlsvertrag, die Flags, Regeln zur Quellenauswahl und Sonderfälle finden Sie unter openclaw plugins.

Typischer CLI-Workflow: Suchen Sie ein Paket, installieren Sie es über ClawHub, npm, git oder einen lokalen Pfad, lassen Sie den verwalteten Gateway automatisch neu starten (oder starten Sie ihn manuell neu) und überprüfen Sie anschließend die Laufzeitregistrierungen des Plugins.

Control UI verwenden

Öffnen Sie Plugins in der Control UI oder verwenden Sie /settings/plugins relativ zum konfigurierten Basispfad der Control UI. Beispielsweise verwendet der Basispfad /openclaw den Pfad /openclaw/settings/plugins. Die Seite verfügt über zwei Registerkarten:

• Installiert zeigt den vollständigen lokalen Bestand, gruppiert nach Kategorien (Kanäle, Modell-Provider, Speicher, Werkzeuge). Jede Zeile öffnet eine Detailansicht; über das Überlaufmenü (…) kann das Plugin aktiviert oder deaktiviert werden, und für extern installierte Plugins bietet es Entfernen an. Die Registerkarte führt außerdem die konfigurierten MCP-Server mit denselben menügesteuerten Aktionen zum Aktivieren, Deaktivieren und Entfernen auf, wobei mcp.servers in der Gateway-Konfiguration bearbeitet wird.
• Entdecken ist der Store: hervorgehobene, in OpenClaw enthaltene Plugins, offizielle externe Plugins und eine kuratierte Auswahl an Konnektoren. Konnektorkarten fügen entweder mit einem Klick einen gehosteten MCP-Server hinzu (GitHub, Notion, Linear, Sentry, Home Assistant) oder öffnen eine vorausgefüllte ClawHub-Suche. Eingaben in das Suchfeld fragen ClawHub direkt ab und hängen einen Abschnitt Von ClawHub mit Downloadzahlen und Kennzeichnungen zur Quellenüberprüfung an.

Enthaltene Plugins müssen nicht als Paket installiert werden. Ihre Menüaktion lautet Aktivieren oder Deaktivieren. Workboard ist beispielsweise in OpenClaw enthalten und standardmäßig deaktiviert. Wählen Sie daher Aktivieren, um es einzuschalten. Gebündelte Plugins können nicht entfernt, sondern nur deaktiviert werden.

Der Zugriff auf Katalog und Suche erfordert operator.read. Installation, Aktivierung, Deaktivierung, Entfernung und Änderungen an MCP-Servern erfordern operator.admin. Eine ClawHub-Installation wird vom Gateway ausgeführt und behält dessen Prüfungen für Vertrauenswürdigkeit, Integrität und Plugin-Installationsrichtlinien bei. Wenn ein installiertes Plugin als Administrator aktiviert wird, wird dieses ausdrückliche Vertrauen ebenfalls vermerkt, indem das ausgewählte Plugin einer vorhandenen restriktiven Liste plugins.allow hinzugefügt wird. Ein expliziter Eintrag plugins.deny bleibt maßgeblich und muss entfernt werden, bevor das Plugin aktiviert werden kann.

Das Installieren oder Entfernen von Plugin-Code erfordert einen Neustart des Gateways. Änderungen an der Aktivierung können ohne Neustart angewendet werden, wenn das installierte Plugin und die aktuelle Gateway-Laufzeit dies unterstützen; andernfalls weist die UI darauf hin, dass ein Neustart erforderlich ist. OAuth-gestützte MCP-Konnektoren benötigen nach dem Hinzufügen weiterhin einmalig openclaw mcp login <name> über die CLI.

Die Control UI installiert nicht aus beliebigen npm-, git- oder lokalen Pfadquellen, aktualisiert keine Plugins und stellt keine umfangreiche Plugin-Konfiguration bereit. Verwenden Sie für diese Vorgänge die folgenden CLI-Workflows.

Plugins auflisten und suchen

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --jsonopenclaw plugins search "calendar"

--json für Skripte:

openclaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list ist eine Bestandsprüfung im inaktiven Zustand: Sie zeigt, was OpenClaw anhand von Konfiguration, Manifesten und der persistenten Plugin-Registry erkennen kann. Sie belegt nicht, dass ein bereits ausgeführter Gateway die Plugin-Laufzeit importiert hat. Die JSON-Ausgabe enthält Registry-Diagnosen und für jedes Plugin dessen dependencyStatus (ob deklarierte dependencies/optionalDependencies auf dem Datenträger aufgelöst werden können).

plugins search fragt ClawHub nach installierbaren Plugin-Paketen ab und gibt für jedes Ergebnis einen Installationshinweis (openclaw plugins install clawhub:<package>) aus.

Plugins aktivieren und deaktivieren

openclaw plugins enable <plugin-id>openclaw plugins disable <plugin-id>

Schaltet den Konfigurationseintrag eines Plugins um, ohne installierte Dateien zu verändern. Einige gebündelte Plugins (gebündelte Modell-/Sprach-Provider sowie das gebündelte Browser-Plugin) sind standardmäßig aktiviert; andere erfordern nach der Installation enable.

Plugins installieren

# ClawHub nach Plugin-Paketen durchsuchen.openclaw plugins search "calendar" # Von ClawHub installieren.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Von npm installieren.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/[email protected]openclaw plugins install npm:@openclaw/codex # Aus einem lokalen npm-pack-Artefakt installieren.openclaw plugins install npm-pack:<path.tgz> # Aus git oder einem lokalen Entwicklungs-Checkout installieren.openclaw plugins install git:github.com/acme/[email protected]openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Reine Paketspezifikationen werden während der Umstellung beim Start aus npm installiert, sofern der Name nicht mit der ID eines gebündelten oder offiziellen Plugins übereinstimmt. In diesem Fall verwendet OpenClaw stattdessen diese lokale/offizielle Kopie. Verwenden Sie clawhub:, npm:, git: oder npm-pack: für eine deterministische Quellenauswahl. Die gebündelten und offiziellen Katalogpakete von OpenClaw gelten ebenso wie ClawHub-Pakete als vertrauenswürdig. Neue beliebige npm-, git-, lokale Pfad-/Archiv-, npm-pack:- oder Marketplace-Quellen erfordern bei nicht interaktiven Installationen --force, nachdem Sie die Quelle geprüft und als vertrauenswürdig eingestuft haben.

--force bestätigt eine Quelle außerhalb von ClawHub ohne Rückfrage und überschreibt bei Bedarf ein vorhandenes Installationsziel. Verwenden Sie für routinemäßige Upgrades einer nachverfolgten npm-, ClawHub- oder Hook-Pack-Installation stattdessen openclaw plugins update. Bei --link bestätigt --force nur die Quelle; das verknüpfte Verzeichnis wird weder kopiert noch überschrieben.

Wenn ein neu installiertes Plugin eine noch nicht vorhandene Konfiguration erfordert, zeichnet OpenClaw die Installation auf, lässt das Plugin jedoch deaktiviert. Konfigurieren Sie plugins.entries.<id>.config und führen Sie anschließend openclaw plugins enable <id> aus. Wenn ein vorhandener Konfigurationseintrag ungültig ist, schlägt die Installation fehl, ohne ihn neu zu schreiben.

Neu starten und prüfen

Ein ausgeführter verwalteter Gateway mit aktivierter Konfigurationsneuladung startet nach der Installation, Aktualisierung oder Deinstallation von Plugin-Code automatisch neu. Wenn der Gateway nicht verwaltet wird oder das Neuladen deaktiviert ist, starten Sie ihn selbst neu, bevor Sie aktive Laufzeitoberflächen prüfen:

openclaw gateway restartopenclaw plugins inspect <plugin-id> --runtime --json

inspect --runtime lädt das Plugin-Modul und belegt, dass es Laufzeitoberflächen registriert hat (Werkzeuge, Hooks, Dienste, Gateway-Methoden, HTTP-Routen, Plugin-eigene CLI-Befehle). Einfaches inspect und list sind lediglich inaktive Prüfungen von Manifest, Konfiguration und Registry.

Plugins aktualisieren

openclaw plugins update <plugin-id>openclaw plugins update <npm-package-or-spec>openclaw plugins update --allopenclaw plugins update <plugin-id> --dry-run

Durch die Übergabe einer Plugin-ID wird deren nachverfolgte Installationsspezifikation wiederverwendet: Gespeicherte Dist-Tags (@beta) und exakt fixierte Versionen werden bei späteren Ausführungen von update <plugin-id> übernommen.

openclaw plugins update --all ist der Pfad für die Massenwartung. Er berücksichtigt weiterhin gewöhnliche nachverfolgte Installationsspezifikationen, aber vertrauenswürdige offizielle OpenClaw-Plugin-Einträge werden mit dem aktuellen Ziel des offiziellen Katalogs synchronisiert, statt auf ein veraltetes exaktes offizielles Paket fixiert zu bleiben. Wenn update.channel den Wert beta hat, bevorzugt diese Synchronisierung die Beta-Veröffentlichungslinie. Verwenden Sie ein gezieltes update <plugin-id>, um eine exakte oder mit einem Tag versehene offizielle Spezifikation unverändert beizubehalten.

Übergeben Sie bei npm-Installationen eine explizite Paketspezifikation, um den nachverfolgten Eintrag zu wechseln:

openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-plugin

Der zweite Befehl verschiebt ein Plugin zurück auf die standardmäßige Veröffentlichungslinie der Registry, wenn es zuvor auf eine exakte Version oder ein Tag fixiert war.

Die genauen Fallback- und Fixierungsregeln finden Sie unter openclaw plugins.

Plugins deinstallieren

openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-files

Bei der Deinstallation werden der Konfigurationseintrag des Plugins, der persistente Plugin-Indexeintrag, Einträge in Zulassungs-/Sperrlisten und gegebenenfalls verknüpfte plugins.load.paths-Einträge entfernt. Das verwaltete Installationsverzeichnis wird entfernt, sofern Sie nicht --keep-files übergeben. Ein ausgeführter verwalteter Gateway startet automatisch neu, wenn die Deinstallation die Plugin-Quelle ändert.

Im Nix-Modus (OPENCLAW_NIX_MODE=1) sind Installation, Aktualisierung, Deinstallation, Aktivierung und Deaktivierung von Plugins vollständig deaktiviert; verwalten Sie diese Optionen stattdessen in der Nix-Quelle der Installation.

Quelle auswählen

Verwaltete Installationen über lokale Pfade müssen Plugin-Verzeichnisse oder Archive sein. Legen Sie eigenständige Plugin-Dateien in plugins.load.paths ab, anstatt sie mit plugins install zu installieren.

Plugins veröffentlichen

ClawHub ist die primäre öffentliche Oberfläche zur Ermittlung von OpenClaw-Plugins. Veröffentlichen Sie dort, wenn Benutzer vor der Installation Plugin-Metadaten, Versionsverlauf, Registry-Scanergebnisse und Installationshinweise finden sollen.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/[email protected]

Native npm-Plugins müssen vor der Veröffentlichung ein Plugin-Manifest (openclaw.plugin.json) sowie package.json-Metadaten enthalten:

{  "name": "@acme/openclaw-plugin",  "version": "1.0.0",  "type": "module",  "openclaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access publicopenclaw plugins install npm:@acme/openclaw-pluginopenclaw plugins install npm:@acme/openclaw-plugin@betaopenclaw plugins install npm:@acme/[email protected]

Verwenden Sie für den vollständigen Veröffentlichungsvertrag diese Seiten, statt diese Seite als Veröffentlichungsreferenz zu behandeln:

• Veröffentlichen auf ClawHub erläutert Eigentümer, Bereiche, Veröffentlichungen, Überprüfung, Paketvalidierung und Paketübertragung.
• Plugins erstellen zeigt die vollständige Struktur eines Plugin-Pakets (einschließlich openclaw.plugin.json) und den Workflow für die erste Veröffentlichung.
• Plugin-Manifest definiert die Felder nativer Plugin-Manifeste.

Wenn dasselbe Paket sowohl auf ClawHub als auch auf npm verfügbar ist, verwenden Sie das explizite Präfix clawhub: oder npm:, um eine Quelle zu erzwingen.

Verwandte Themen

• Plugins – installieren, konfigurieren, neu starten und Fehler beheben
• openclaw plugins – vollständige CLI-Referenz
• Community-Plugins – öffentliche Auffindbarkeit und Veröffentlichung auf ClawHub
• ClawHub – CLI-Operationen für die Registry
• Plugins erstellen – ein Plugin-Paket erstellen
• Plugin-Manifest – Manifest- und Paketmetadaten