Plugins beheren

De Control UI ondersteunt de gebruikelijke workflow voor ontdekken, installeren, inschakelen en uitschakelen. De CLI voegt bijwerken, verwijderen, geavanceerde configuratie en expliciete besturing van de installatiebron toe. Zie openclaw plugins voor het volledige commandocontract, de vlaggen, regels voor bronselectie en randgevallen.

Typische CLI-workflow: zoek een pakket, installeer het vanuit ClawHub, npm, git of een lokaal pad, laat de beheerde Gateway automatisch opnieuw opstarten (of start deze handmatig opnieuw op) en verifieer vervolgens de runtimeregistraties van de plugin.

De Control UI gebruiken

Open Plugins in de Control UI of gebruik /settings/plugins ten opzichte van het geconfigureerde basispad van de Control UI. Een basispad van /openclaw gebruikt bijvoorbeeld /openclaw/settings/plugins. De pagina heeft twee tabbladen:

• Geïnstalleerd toont de volledige lokale inventaris, gegroepeerd op categorie (kanalen, modelproviders, geheugen, tools). Elke rij opent een detailweergave; via het overloopmenu (…) kun je de plugin in- of uitschakelen en voor extern geïnstalleerde plugins is Verwijderen beschikbaar. Het tabblad vermeldt ook de geconfigureerde MCP-servers, met dezelfde menugestuurde acties voor inschakelen, uitschakelen en verwijderen, waarbij mcp.servers in de Gateway-configuratie wordt bewerkt.
• Ontdekken is de winkel: uitgelichte plugins die met OpenClaw worden meegeleverd, officiële externe plugins en een samengestelde verzameling connectors. Connectorkaarten voegen met één klik een gehoste MCP-server toe (GitHub, Notion, Linear, Sentry, Home Assistant) of openen een vooraf ingevulde ClawHub-zoekopdracht. Wanneer je in het zoekvak typt, wordt ClawHub direct doorzocht en wordt een sectie Van ClawHub toegevoegd met downloadaantallen en badges voor bronverificatie.

Meegeleverde plugins hoeven niet als pakket te worden geïnstalleerd. De bijbehorende menuactie is Inschakelen of Uitschakelen. Workboard wordt bijvoorbeeld met OpenClaw meegeleverd en is standaard uitgeschakeld. Kies daarom Inschakelen om het te activeren. Gebundelde plugins kunnen niet worden verwijderd, alleen uitgeschakeld.

Voor toegang tot de catalogus en zoekfunctie is operator.read vereist. Voor installeren, inschakelen, uitschakelen, verwijderen en wijzigingen aan MCP-servers is operator.admin vereist. Een ClawHub-installatie wordt door de Gateway uitgevoerd en behoudt de beleidscontroles voor vertrouwen, integriteit en plugininstallaties. Wanneer een beheerder een geïnstalleerde plugin inschakelt, wordt dat expliciete vertrouwen ook vastgelegd door de geselecteerde plugin toe te voegen aan een bestaande beperkende plugins.allow-lijst. Een expliciete vermelding in plugins.deny blijft doorslaggevend en moet worden verwijderd voordat de plugin kan worden ingeschakeld.

Voor het installeren of verwijderen van plugincode moet de Gateway opnieuw worden opgestart. Wijzigingen in de activeringsstatus kunnen zonder herstart worden toegepast wanneer de geïnstalleerde plugin en de huidige Gateway-runtime dit ondersteunen; anders meldt de UI dat een herstart vereist is. MCP-connectors met OAuth vereisen na toevoeging nog steeds een eenmalige openclaw mcp login <name> via de CLI.

De Control UI kan niet installeren vanuit willekeurige npm-, git- of lokale-padbronnen, plugins bijwerken of uitgebreide pluginconfiguratie beschikbaar stellen. Gebruik voor die bewerkingen de onderstaande CLI-workflows.

Plugins weergeven en zoeken

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

--json voor scripts:

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

plugins list is een koude inventariscontrole: wat OpenClaw kan ontdekken via configuratie, manifesten en het opgeslagen pluginregister. Dit bewijst niet dat een reeds actieve Gateway de pluginruntime heeft geïmporteerd. JSON-uitvoer bevat registerdiagnostiek en de dependencyStatus van elke plugin (of gedeclareerde dependencies/optionalDependencies op schijf kunnen worden gevonden).

plugins search doorzoekt ClawHub naar installeerbare pluginpakketten en toont per resultaat een installatiehint (openclaw plugins install clawhub:<package>).

Plugins inschakelen en uitschakelen

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

Wijzigt de configuratievermelding van een plugin zonder geïnstalleerde bestanden aan te raken. Sommige gebundelde plugins (gebundelde model-/spraakproviders en de gebundelde browserplugin) zijn standaard ingeschakeld; andere vereisen na installatie enable.

Plugins installeren

# Zoek op ClawHub naar pluginpakketten.openclaw plugins search "calendar" # Installeer vanuit ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Installeer vanuit npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/[email protected]openclaw plugins install npm:@openclaw/codex # Installeer vanuit een lokaal npm-pack-artefact.openclaw plugins install npm-pack:<path.tgz> # Installeer vanuit git of een lokale ontwikkelcheckout.openclaw plugins install git:github.com/acme/[email protected]openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Kale pakketspecificaties worden tijdens de overgang bij de lancering vanuit npm geïnstalleerd, tenzij de naam overeenkomt met de id van een gebundelde of officiële plugin. In dat geval gebruikt OpenClaw in plaats daarvan die lokale/officiële kopie. Gebruik clawhub:, npm:, git: of npm-pack: voor deterministische bronselectie. De gebundelde en officiële cataloguspakketten van OpenClaw worden naast ClawHub-pakketten vertrouwd. Nieuwe willekeurige npm-, git-, lokale pad-/archief-, npm-pack:- of marketplacebronnen vereisen --force bij niet-interactieve installaties nadat je de bron hebt beoordeeld en vertrouwd.

--force bevestigt een niet-ClawHub-bron zonder om bevestiging te vragen en overschrijft indien nodig een bestaand installatiedoel. Gebruik voor reguliere upgrades van een gevolgde npm-, ClawHub- of hook-pack-installatie in plaats daarvan openclaw plugins update. Met --link bevestigt --force alleen de bron; de gekoppelde map wordt niet gekopieerd of overschreven.

Opnieuw opstarten en inspecteren

Een actieve beheerde Gateway waarvoor het opnieuw laden van configuratie is ingeschakeld, start automatisch opnieuw op na het installeren, bijwerken of verwijderen van plugincode. Als de Gateway niet wordt beheerd of opnieuw laden is uitgeschakeld, start je deze zelf opnieuw op voordat je actieve runtime-oppervlakken controleert:

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

inspect --runtime laadt de pluginmodule en bewijst dat deze runtime-oppervlakken heeft geregistreerd (tools, hooks, services, Gateway-methoden, HTTP-routes en CLI-opdrachten die eigendom zijn van de plugin). Gewone inspect en list zijn alleen koude controles van manifest, configuratie en register.

Plugins bijwerken

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

Wanneer je een plugin-id doorgeeft, wordt de gevolgde installatiespecificatie opnieuw gebruikt: opgeslagen dist-tags (@beta) en exact vastgezette versies worden overgenomen bij latere uitvoeringen van update <plugin-id>.

openclaw plugins update --all is het pad voor bulkonderhoud. Het respecteert nog steeds gewone gevolgde installatiespecificaties, maar vertrouwde officiële OpenClaw-pluginrecords worden gesynchroniseerd met het huidige officiële catalogusdoel in plaats van vastgezet te blijven op een verouderd exact officieel pakket. Wanneer update.channel beta is, geeft die synchronisatie de voorkeur aan de bètaversielijn. Gebruik een gerichte update <plugin-id> om een exacte of getagde officiële specificatie ongewijzigd te laten.

Geef voor npm-installaties een expliciete pakketspecificatie door om het gevolgde record te wijzigen:

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

Met de tweede opdracht wordt een plugin teruggezet naar de standaardversielijn van het register als deze eerder was vastgezet op een exacte versie of tag.

Zie openclaw plugins voor de exacte fallback- en vastzetregels.

Plugins verwijderen

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

Bij verwijderen worden de configuratievermelding van de plugin, het opgeslagen pluginindexrecord, vermeldingen in toelatings-/weigeringslijsten en, indien van toepassing, gekoppelde plugins.load.paths-vermeldingen verwijderd. De beheerde installatiemap wordt verwijderd, tenzij je --keep-files doorgeeft. Een actieve beheerde Gateway start automatisch opnieuw op wanneer door de verwijdering de pluginbron verandert.

In Nix-modus (OPENCLAW_NIX_MODE=1) zijn het installeren, bijwerken, verwijderen, inschakelen en uitschakelen van plugins allemaal uitgeschakeld; beheer deze keuzes in plaats daarvan in de Nix-bron voor de installatie.

Een bron kiezen

Beheerde installaties vanaf een lokaal pad moeten pluginmappen of archieven zijn. Plaats zelfstandige pluginbestanden in plugins.load.paths in plaats van ze met plugins install te installeren.

Plugins publiceren

ClawHub is het primaire openbare ontdekkingsoppervlak voor OpenClaw-plugins. Publiceer daar wanneer je wilt dat gebruikers pluginmetadata, versiegeschiedenis, registerscanresultaten en installatiehints kunnen vinden voordat ze installeren.

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]

Eigen npm-plugins moeten vóór publicatie een pluginmanifest (openclaw.plugin.json) plus package.json-metadata bevatten:

{  "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]

Gebruik deze pagina's voor het volledige publicatiecontract in plaats van deze pagina als publicatiereferentie te behandelen:

• Publiceren op ClawHub legt eigenaren, scopes, releases, beoordeling, pakketvalidatie en pakketoverdracht uit.
• Plugins bouwen toont de volledige vorm van het pluginpakket (inclusief openclaw.plugin.json) en de workflow voor de eerste publicatie.
• Pluginmanifest definieert de velden van het eigen pluginmanifest.

Als hetzelfde pakket zowel op ClawHub als npm beschikbaar is, gebruik je het expliciete voorvoegsel clawhub: of npm: om één bron af te dwingen.

Gerelateerd

• Plugins - installeren, configureren, opnieuw opstarten en problemen oplossen
• openclaw plugins - volledige CLI-referentie
• Communityplugins - openbare ontdekking en publicatie op ClawHub
• ClawHub - CLI-bewerkingen voor het register
• Plugins bouwen - een pluginpakket maken
• Pluginmanifest - manifest- en pakketmetadata