Plugins beheren

De meeste plugin-workflows bestaan uit een paar opdrachten: zoeken, installeren, de Gateway herstarten, verifiëren en verwijderen wanneer je de plugin niet meer nodig hebt.

Plugins weergeven

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --json

Gebruik --json voor scripts. Het bevat registerdiagnostiek en de statische dependencyStatus van elke plugin wanneer het pluginpakket dependencies of optionalDependencies declareert.

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

plugins list is een koude inventariscontrole. Het toont wat OpenClaw kan vinden via configuratie, manifests en het pluginregister; het bewijst niet dat een al draaiend Gateway-proces de plugin-runtime heeft geïmporteerd.

Plugins installeren

# 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.3openclaw plugins install clawhub:<package>@betaopenclaw plugins install npm:@scope/[email protected]openclaw plugins install npm:@openclaw/codex # Install from git or a local development checkout.openclaw plugins install git:github.com/acme/[email protected]openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Herstart na het installeren van plugincode de Gateway die je kanalen bedient:

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

Gebruik inspect --runtime wanneer je bewijs nodig hebt dat de plugin runtime-oppervlakken heeft geregistreerd, zoals tools, hooks, services, Gateway-methoden of CLI-opdrachten die eigendom zijn van de plugin.

Plugins bijwerken

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

Als een plugin is geïnstalleerd vanaf een npm-dist-tag zoals @beta, gebruiken latere aanroepen van update <plugin-id> die vastgelegde tag opnieuw. Door een expliciete npm-specificatie door te geven, wordt de gevolgde installatie voor toekomstige updates naar die specificatie overgezet.

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

De tweede opdracht verplaatst een plugin terug naar de standaardreleasereeks van het register wanneer deze eerder was vastgezet op een exacte versie of tag.

Wanneer openclaw update op het bètakanaal draait, proberen npm- en ClawHub-pluginrecords op de standaardreeks eerst de overeenkomende @beta-release van de plugin. Als die bètarelease niet bestaat, valt OpenClaw terug op de vastgelegde standaard-/laatste specificatie. Voor npm-plugins valt OpenClaw ook terug wanneer het bètapakket bestaat maar niet door de installatievalidatie komt. Exacte versies en expliciete tags zoals @rc of @beta blijven behouden.

Plugins verwijderen

openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-filesopenclaw gateway restart

Verwijderen haalt de configuratievermelding van de plugin, het pluginindexrecord, allow-/denylist- vermeldingen en gekoppelde laadpaden weg wanneer van toepassing. Beheerde installatiemappen worden verwijderd, tenzij je --keep-files doorgeeft.

In Nix-modus (OPENCLAW_NIX_MODE=1) zijn opdrachten voor het installeren, bijwerken, verwijderen, inschakelen en uitschakelen van plugins uitgeschakeld. Beheer die keuzes in plaats daarvan in de Nix-bron voor de installatie; gebruik voor nix-openclaw de agent-first Snelstart.

Plugins publiceren

Je kunt externe plugins publiceren naar ClawHub, npmjs.com of beide.

Publiceren naar ClawHub

ClawHub is het primaire openbare ontdekkingsoppervlak voor OpenClaw-plugins. Het geeft gebruikers doorzoekbare metadata, versiegeschiedenis en resultaten van registerscans vóór installatie.

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]

Gebruikers installeren vanuit ClawHub met:

openclaw plugins install clawhub:<package>openclaw plugins install <package>

De kale vorm controleert nog steeds eerst ClawHub.

Publiceren naar npmjs.com

Native npm-plugins moeten een pluginmanifest en OpenClaw-entrypointmetadata in package.json bevatten.

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

npm publish --access public

Gebruikers installeren npm-only met:

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

Als hetzelfde pakket ook beschikbaar is op ClawHub, slaat npm: de ClawHub-lookup over en forceert het npm-resolutie.

Bronkeuze

• ClawHub: gebruik dit wanneer je OpenClaw-native ontdekking, scansamenvattingen, versies en installatietips wilt.
• npmjs.com: gebruik dit wanneer je al JavaScript-pakketten levert of npm- dist-tags/private-registerworkflows nodig hebt.
• Git: gebruik dit wanneer je rechtstreeks vanaf een branch, tag of commit wilt installeren.
• Lokaal pad: gebruik dit wanneer je een plugin op dezelfde machine ontwikkelt of test.

Gerelateerd

• Plugins - overzicht en probleemoplossing
• openclaw plugins - volledige CLI-referentie
• ClawHub - publicatie- en registerbewerkingen
• Plugins bouwen - een pluginpakket maken
• Pluginmanifest - manifest- en pakketmetadata