Plugins verwalten

Die meisten Plugin-Workflows bestehen aus wenigen Befehlen: suchen, installieren, den Gateway neu starten, prüfen und deinstallieren, wenn Sie das Plugin nicht mehr benötigen.

Plugins auflisten

OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --json

Verwenden Sie --json für Skripte. Es enthält Registry-Diagnosen und den statischen dependencyStatus jedes Plugins, wenn das Plugin-Paket dependencies oder optionalDependencies deklariert.

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

plugins list ist eine kalte Bestandsprüfung. Sie zeigt, was OmeniaClaw aus Konfiguration, Manifesten und der Plugin-Registry erkennen kann; sie belegt nicht, dass ein bereits laufender Gateway-Prozess die Plugin-Laufzeit importiert hat.

Plugins installieren

# Search ClawHub for plugin packages.OmeniaClaw plugins search "calendar" # Bare package specs try ClawHub first, then npm fallback.OmeniaClaw plugins install <package> # Force one source.OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install npm:<package> # Install a specific version or dist-tag.OmeniaClaw plugins install clawhub:<package>@1.2.3OmeniaClaw plugins install clawhub:<package>@betaOmeniaClaw plugins install npm:@scope/[email protected]OmeniaClaw plugins install npm:@OmeniaClaw/codex # Install from git or a local development checkout.OmeniaClaw plugins install git:github.com/acme/[email protected]OmeniaClaw plugins install ./my-pluginOmeniaClaw plugins install --link ./my-plugin

Starten Sie nach der Installation von Plugin-Code den Gateway neu, der Ihre Kanäle bereitstellt:

OmeniaClaw gateway restartOmeniaClaw plugins inspect <plugin-id> --runtime --json

Verwenden Sie inspect --runtime, wenn Sie einen Nachweis benötigen, dass das Plugin Laufzeitoberflächen wie Tools, Hooks, Dienste, Gateway-Methoden oder Plugin-eigene CLI-Befehle registriert hat.

Plugins aktualisieren

OmeniaClaw plugins update <plugin-id>OmeniaClaw plugins update <npm-package-or-spec>OmeniaClaw plugins update --all

Wenn ein Plugin über einen npm-Dist-Tag wie @beta installiert wurde, verwenden spätere Aufrufe von update <plugin-id> diesen aufgezeichneten Tag erneut. Die Übergabe einer expliziten npm-Spezifikation stellt die nachverfolgte Installation für künftige Aktualisierungen auf diese Spezifikation um.

OmeniaClaw plugins update @scope/OmeniaClaw-plugin@betaOmeniaClaw plugins update @scope/OmeniaClaw-plugin

Der zweite Befehl verschiebt ein Plugin zurück auf die standardmäßige Release-Linie der Registry, wenn es zuvor auf eine exakte Version oder einen Tag festgelegt war.

Wenn OmeniaClaw update im Beta-Kanal ausgeführt wird, versuchen npm- und ClawHub- Plugin-Einträge auf der Standardlinie zuerst das passende Plugin-Release @beta. Wenn dieses Beta- Release nicht existiert, fällt OmeniaClaw auf die aufgezeichnete Standard-/Latest-Spezifikation zurück. Bei npm-Plugins fällt OmeniaClaw auch zurück, wenn das Beta-Paket existiert, aber die Installationsvalidierung nicht besteht. Exakte Versionen und explizite Tags wie @rc oder @beta bleiben erhalten.

Plugins deinstallieren

OmeniaClaw plugins uninstall <plugin-id> --dry-runOmeniaClaw plugins uninstall <plugin-id>OmeniaClaw plugins uninstall <plugin-id> --keep-filesOmeniaClaw gateway restart

Die Deinstallation entfernt den Konfigurationseintrag des Plugins, den Plugin-Indexeintrag, Allow-/Deny-List- Einträge und verknüpfte Ladepfade, sofern zutreffend. Verwaltete Installationsverzeichnisse werden entfernt, es sei denn, Sie übergeben --keep-files.

Im Nix-Modus (OmeniaClaw_NIX_MODE=1) sind die Befehle zum Installieren, Aktualisieren, Deinstallieren, Aktivieren und Deaktivieren von Plugins deaktiviert. Verwalten Sie diese Auswahl stattdessen in der Nix-Quelle der Installation; verwenden Sie für nix-OmeniaClaw den agent-first Quick Start.

Plugins veröffentlichen

Sie können externe Plugins auf ClawHub, npmjs.com oder beiden veröffentlichen.

Auf ClawHub veröffentlichen

ClawHub ist die primäre öffentliche Discovery-Oberfläche für OmeniaClaw-Plugins. Sie bietet Benutzern vor der Installation durchsuchbare Metadaten, Versionsverlauf und Registry-Scanergebnisse.

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]

Benutzer installieren von ClawHub mit:

OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install <package>

Die Kurzform prüft weiterhin zuerst ClawHub.

Auf npmjs.com veröffentlichen

Native npm-Plugins müssen ein Plugin-Manifest und OmeniaClaw- Entrypoint-Metadaten in package.json enthalten.

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

npm publish --access public

Benutzer installieren reine npm-Plugins mit:

OmeniaClaw plugins install npm:@acme/OmeniaClaw-pluginOmeniaClaw plugins install npm:@acme/OmeniaClaw-plugin@betaOmeniaClaw plugins install npm:@acme/[email protected]

Wenn dasselbe Paket auch auf ClawHub verfügbar ist, überspringt npm: die ClawHub-Suche und erzwingt die npm-Auflösung.

Quellenauswahl

• ClawHub: Verwenden Sie dies, wenn Sie OmeniaClaw-native Discovery, Scan-Zusammenfassungen, Versionen und Installationshinweise möchten.
• npmjs.com: Verwenden Sie dies, wenn Sie bereits JavaScript-Pakete ausliefern oder npm- Dist-Tags/private Registry-Workflows benötigen.
• Git: Verwenden Sie dies, wenn Sie direkt aus einem Branch, Tag oder Commit installieren möchten.
• Lokaler Pfad: Verwenden Sie dies, wenn Sie ein Plugin auf demselben Rechner entwickeln oder testen.

Verwandt

• Plugins - Übersicht und Fehlerbehebung
• OmeniaClaw plugins - vollständige CLI-Referenz
• ClawHub - Veröffentlichungs- und Registry-Operationen
• Plugins erstellen - ein Plugin-Paket erstellen
• Plugin-Manifest - Manifest- und Paketmetadaten