Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Plugins auflisten

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw 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. 
openclaw plugins list --json \
  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'
plugins list ist eine kalte Bestandsprüfung. Der Befehl zeigt, was OpenClaw aus Konfiguration, Manifesten und der Plugin-Registry erkennen kann; er belegt nicht, dass ein bereits laufender Gateway-Prozess die Plugin-Laufzeit importiert hat.

​
Plugins installieren

# Search ClawHub for plugin packages.
openclaw plugins search "calendar"

# Bare package specs try ClawHub first, then npm fallback.
openclaw plugins install <package>

# Force one source.
openclaw plugins install clawhub:<package>
openclaw plugins install npm:<package>

# Install a specific version or dist-tag.
openclaw plugins install clawhub:<package>@1.2.3
openclaw plugins install clawhub:<package>@beta
openclaw plugins install npm:@scope/openclaw-plugin@1.2.3
openclaw plugins install npm:@openclaw/codex

# Install from git or a local development checkout.
openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0
openclaw plugins install ./my-plugin
openclaw plugins install --link ./my-plugin
Starten Sie nach der Installation von Plugin-Code den Gateway neu, der Ihre Kanäle bedient: 
openclaw gateway restart
openclaw plugins inspect <plugin-id> --runtime --json
Verwenden Sie inspect --runtime, wenn Sie einen Nachweis benötigen, dass das Plugin Laufzeitoberflächen registriert hat, etwa Tools, Hooks, Dienste, Gateway-Methoden oder Plugin-eigene CLI-Befehle.

​
Plugins aktualisieren

openclaw plugins update <plugin-id>
openclaw plugins update <npm-package-or-spec>
openclaw plugins update --all
Wenn ein Plugin aus einem npm-Dist-Tag wie @beta installiert wurde, verwenden spätere update <plugin-id>-Aufrufe dieses gespeicherte Tag erneut. Die Übergabe einer expliziten npm-Spezifikation stellt die nachverfolgte Installation für zukünftige Aktualisierungen auf diese Spezifikation um. 
openclaw plugins update @scope/openclaw-plugin@beta
openclaw plugins update @scope/openclaw-plugin
Der zweite Befehl verschiebt ein Plugin zurück auf die Standard-Release-Linie der Registry, wenn es zuvor auf eine exakte Version oder ein Tag festgelegt war. Wenn openclaw update im Beta-Kanal läuft, versuchen npm- und ClawHub-Plugin- Einträge auf der Standardlinie zuerst das passende Plugin-Release @beta. Wenn dieses Beta-Release nicht existiert, fällt OpenClaw auf die gespeicherte Standard-/Latest-Spezifikation zurück. Bei npm-Plugins fällt OpenClaw auch dann zurück, wenn das Beta-Paket existiert, aber die Installationsvalidierung fehlschlägt. Exakte Versionen und explizite Tags wie @rc oder @beta bleiben erhalten.

​
Plugins deinstallieren

openclaw plugins uninstall <plugin-id> --dry-run
openclaw plugins uninstall <plugin-id>
openclaw plugins uninstall <plugin-id> --keep-files
openclaw 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, sofern Sie nicht --keep-files übergeben. Im Nix-Modus (OPENCLAW_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; für nix-openclaw verwenden Sie 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 OpenClaw-Plugins. Sie bietet Nutzern durchsuchbare Metadaten, Versionsverlauf und Registry-Scanergebnisse vor der Installation. 
npm i -g clawhub
clawhub login
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/your-plugin@v1.0.0
Nutzer installieren aus ClawHub mit: 
openclaw plugins install clawhub:<package>
openclaw plugins install <package>
Die Kurzform prüft weiterhin zuerst ClawHub.

​
Auf npmjs.com veröffentlichen

Native npm-Plugins müssen ein Plugin-Manifest und OpenClaw-Einstiegspunkt- Metadaten in package.json enthalten.
package.json
{
  "name": "@acme/openclaw-plugin",
  "version": "1.0.0",
  "type": "module",
  "openclaw": {
    "extensions": ["./dist/index.js"]
  }
}

npm publish --access public
Nutzer installieren nur-npm-Pakete mit: 
openclaw plugins install npm:@acme/openclaw-plugin
openclaw plugins install npm:@acme/openclaw-plugin@beta
openclaw plugins install npm:@acme/openclaw-plugin@1.0.0
Wenn dasselbe Paket auch auf ClawHub verfügbar ist, überspringt npm: die ClawHub-Suche und erzwingt die npm-Auflösung.

​
Quellenauswahl

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

​
Verwandte Themen