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 starten (of start deze handmatig opnieuw) en controleer 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 inschakelen 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, waarbijmcp.serversin de Gateway-configuratie wordt bewerkt. - Ontdekken is de winkel: uitgelichte plugins die bij OpenClaw zijn inbegrepen, officiële externe plugins en een beheerde 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. Als je in het zoekvak typt, wordt ClawHub direct doorzocht en wordt een sectie Van ClawHub toegevoegd met downloadaantallen en badges voor bronverificatie.
operator.read vereist. Voor installeren, inschakelen, uitschakelen, verwijderen en wijzigingen aan MCP-servers is operator.admin vereist. Een ClawHub-installatie wordt uitgevoerd door de Gateway en behoudt de controles voor vertrouwen, integriteit en het installatiebeleid voor plugins. 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 plugins.deny-vermelding blijft bepalend en moet worden verwijderd voordat de plugin kan worden ingeschakeld.
Voor het installeren of verwijderen van plugincode moet de Gateway opnieuw worden gestart. Wijzigingen in de inschakelstatus 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> vanuit de CLI.
De Control UI installeert niet vanuit willekeurige npm-, git- of lokale-padbronnen, werkt plugins niet bij en biedt geen uitgebreide pluginconfiguratie. Gebruik de onderstaande CLI-workflows voor deze bewerkingen.
Plugins weergeven en zoeken
--json voor scripts:
plugins list is een koude inventariscontrole: wat OpenClaw kan ontdekken via de configuratie, manifesten en het permanente pluginregister. Hiermee wordt niet aangetoond 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
enable vereist.
Plugins installeren
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 marktplaatsbronnen vereisen --force bij niet-interactieve installaties nadat je de bron hebt beoordeeld en vertrouwd.
--force bevestigt een bron die niet van ClawHub afkomstig is zonder om bevestiging te vragen en overschrijft indien nodig een bestaand installatiedoel. Gebruik voor reguliere upgrades van een bijgehouden 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.
Als een pas geïnstalleerde plugin configuratie vereist die nog niet aanwezig is, legt OpenClaw de installatie vast maar laat het de plugin uitgeschakeld. Configureer plugins.entries.<id>.config en voer vervolgens openclaw plugins enable <id> uit. Als er een bestaande configuratievermelding aanwezig maar ongeldig is, mislukt de installatie zonder deze te herschrijven.
Opnieuw starten en inspecteren
Een actieve beheerde Gateway waarvoor het herladen van configuratie is ingeschakeld, start automatisch opnieuw na het installeren, bijwerken of verwijderen van plugincode. Als de Gateway onbeheerd is of herladen is uitgeschakeld, start je deze zelf opnieuw voordat je actieve runtime-oppervlakken controleert:inspect --runtime laadt de pluginmodule en toont aan 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
@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 reguliere bijgehouden 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ètareleaselijn. Gebruik een gerichte update <plugin-id> om een exacte of getagde officiële specificatie ongewijzigd te behouden.
Geef voor npm-installaties een expliciete pakketspecificatie door om het bijgehouden record te wijzigen:
openclaw plugins voor de exacte fallback- en vastzetregels.
Plugins verwijderen
plugins.load.paths-vermeldingen verwijderd. De beheerde installatiemap wordt verwijderd, tenzij je --keep-files doorgeeft. Een actieve beheerde Gateway start automatisch opnieuw 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 te installeren met plugins install.
Plugins publiceren
ClawHub is het primaire openbare ontdekkingsoppervlak voor OpenClaw-plugins. Publiceer daar wanneer je wilt dat gebruikers pluginmetadata, versiegeschiedenis, scanresultaten van het register en installatiehints kunnen vinden voordat ze installeren.openclaw.plugin.json) plus package.json-metadata bevatten:
package.json
- Publiceren op ClawHub beschrijft eigenaren, scopes, releases, beoordeling, pakketvalidatie en pakketoverdracht.
- Plugins bouwen toont de volledige structuur van een pluginpakket (inclusief
openclaw.plugin.json) en de workflow voor de eerste publicatie. - Pluginmanifest definieert de velden van het native pluginmanifest.
clawhub: of npm: om één bron af te dwingen.
Gerelateerd
- Plugins - installeren, configureren, opnieuw starten en problemen oplossen
openclaw plugins- volledige CLI-referentie- Communityplugins - openbaar ontdekken en publiceren op ClawHub
- ClawHub - CLI-bewerkingen voor het register
- Plugins bouwen - een pluginpakket maken
- Pluginmanifest - manifest- en pakketmetadata