--- read_when: - Je wilt Gateway-plugins of compatibele bundels installeren of beheren - Je wilt Plugin-laadfouten debuggen sidebarTitle: Plugins summary: CLI-referentie voor `openclaw plugins` (list, install, marketplace, uninstall, enable/disable, doctor) title: Plugins x-i18n: generated_at: "2026-05-12T08:45:20Z" model: gpt-5.5 provider: openai source_hash: 4b51646a103e9e020f6e53cd08aa25e7291fb629741fd41bdab520d80b7416ff source_path: cli/plugins.md workflow: 16 --- Beheer Gateway-plugins, hook-packs en compatibele bundels. Eindgebruikershandleiding voor het installeren, inschakelen en oplossen van problemen met plugins. Snelle voorbeelden voor installeren, weergeven, bijwerken, verwijderen en publiceren. Compatibiliteitsmodel voor bundels. Manifestvelden en configuratieschema. Beveiligingsverharding voor plugin-installaties. ## Opdrachten ```bash openclaw plugins list openclaw plugins list --enabled openclaw plugins list --verbose openclaw plugins list --json openclaw plugins search openclaw plugins search --limit 20 openclaw plugins search --json openclaw plugins install openclaw plugins inspect openclaw plugins inspect --runtime openclaw plugins inspect --json openclaw plugins inspect --all openclaw plugins info openclaw plugins enable openclaw plugins disable openclaw plugins registry openclaw plugins registry --refresh openclaw plugins uninstall openclaw plugins doctor openclaw plugins update openclaw plugins update --all openclaw plugins marketplace list openclaw plugins marketplace list --json ``` Voor onderzoek naar trage installatie, inspectie, verwijdering of registry-verversing voer je de opdracht uit met `OPENCLAW_PLUGIN_LIFECYCLE_TRACE=1`. De trace schrijft fasetimings naar stderr en houdt JSON-uitvoer parseerbaar. Zie [Debugging](/nl/help/debugging#plugin-lifecycle-trace). In Nix-modus (`OPENCLAW_NIX_MODE=1`) zijn mutators voor de plugin-levenscyclus uitgeschakeld. Gebruik voor deze installatie de Nix-bron in plaats van `plugins install`, `plugins update`, `plugins uninstall`, `plugins enable` of `plugins disable`; gebruik voor nix-openclaw de agent-first [Snelstart](https://github.com/openclaw/nix-openclaw#quick-start). Gebundelde plugins worden met OpenClaw meegeleverd. Sommige zijn standaard ingeschakeld (bijvoorbeeld gebundelde modelproviders, gebundelde spraakproviders en de gebundelde browserplugin); andere vereisen `plugins enable`. Native OpenClaw-plugins moeten `openclaw.plugin.json` leveren met een inline JSON Schema (`configSchema`, zelfs als dit leeg is). Compatibele bundels gebruiken in plaats daarvan hun eigen bundelmanifesten. `plugins list` toont `Format: openclaw` of `Format: bundle`. Uitgebreide lijst-/info-uitvoer toont ook het bundelsubtype (`codex`, `claude` of `cursor`) plus gedetecteerde bundelmogelijkheden. ### Installeren ```bash openclaw plugins search "calendar" # search ClawHub plugins openclaw plugins install # npm by default openclaw plugins install clawhub: # ClawHub only openclaw plugins install npm: # npm only openclaw plugins install npm-pack: # local npm pack through npm install semantics openclaw plugins install git:github.com// # git repo openclaw plugins install git:github.com//@ openclaw plugins install --force # overwrite existing install openclaw plugins install --pin # pin version openclaw plugins install --dangerously-force-unsafe-install openclaw plugins install # local path openclaw plugins install @ # marketplace openclaw plugins install --marketplace # marketplace (explicit) openclaw plugins install --marketplace https://github.com// ``` Maintainers die installaties tijdens setup testen, kunnen automatische plugin-installatiebronnen overschrijven met bewaakte omgevingsvariabelen. Zie [Overschrijvingen voor plugin-installatie](/nl/plugins/install-overrides). Kale pakketnamen installeren tijdens de lanceringsomschakeling standaard vanaf npm. Gebruik `clawhub:` voor ClawHub. Behandel plugin-installaties alsof je code uitvoert. Geef de voorkeur aan vastgepinde versies. `plugins search` zoekt in ClawHub naar installeerbare plugin-pakketten en drukt installatieklare pakketnamen af. Het zoekt in code-plugin- en bundle-plugin-pakketten, niet in Skills. Gebruik `openclaw skills search` voor ClawHub-Skills. ClawHub is het primaire distributie- en ontdekkingsoppervlak voor de meeste plugins. Npm blijft een ondersteunde fallback en direct-installatiepad. Door OpenClaw beheerde `@openclaw/*` plugin-pakketten worden weer op npm gepubliceerd; zie de actuele lijst op [npmjs.com/org/openclaw](https://www.npmjs.com/org/openclaw) of de [plugin-inventaris](/nl/plugins/plugin-inventory). Stabiele installaties gebruiken `latest`. Installaties en updates via het betakanaal geven de voorkeur aan de npm `beta` dist-tag wanneer die tag beschikbaar is, en vallen daarna terug op `latest`. Als je `plugins`-sectie wordt ondersteund door een `$include` met één bestand, schrijven `plugins install/update/enable/disable/uninstall` door naar dat opgenomen bestand en laten ze `openclaw.json` ongemoeid. Root-includes, include-arrays en includes met sibling-overschrijvingen falen gesloten in plaats van te worden afgevlakt. Zie [Config-includes](/nl/gateway/configuration) voor de ondersteunde vormen. Als de configuratie tijdens installatie ongeldig is, faalt `plugins install` normaal gesproken gesloten en wordt je gevraagd eerst `openclaw doctor --fix` uit te voeren. Tijdens het starten en hot reloaden van de Gateway faalt ongeldige plugin-configuratie gesloten zoals elke andere ongeldige configuratie; `openclaw doctor --fix` kan de ongeldige plugin-vermelding in quarantaine plaatsen. De enige gedocumenteerde uitzondering tijdens installatie is een smal herstelpad voor gebundelde plugins voor plugins die expliciet kiezen voor `openclaw.install.allowInvalidConfigRecovery`. `--force` hergebruikt het bestaande installatiedoel en overschrijft een reeds geïnstalleerde plugin of hook-pack ter plekke. Gebruik dit wanneer je bewust dezelfde id opnieuw installeert vanaf een nieuw lokaal pad, archief, ClawHub-pakket of npm-artefact. Voor routinematige upgrades van een al gevolgde npm-plugin geef je de voorkeur aan `openclaw plugins update `. Als je `plugins install` uitvoert voor een plugin-id die al is geïnstalleerd, stopt OpenClaw en verwijst het je naar `plugins update ` voor een normale upgrade, of naar `plugins install --force` wanneer je de huidige installatie echt vanuit een andere bron wilt overschrijven. `--pin` is alleen van toepassing op npm-installaties. Het wordt niet ondersteund met `git:`-installaties; gebruik een expliciete git-ref zoals `git:github.com/acme/plugin@v1.2.3` wanneer je een vastgepinde bron wilt. Het wordt niet ondersteund met `--marketplace`, omdat marketplace-installaties marketplace-bronmetadata bewaren in plaats van een npm-spec. `--dangerously-force-unsafe-install` is een noodoptie voor fout-positieven in de ingebouwde scanner voor gevaarlijke code. Hiermee kan de installatie doorgaan zelfs wanneer de ingebouwde scanner `critical`-bevindingen rapporteert, maar dit omzeilt **niet** de beleidsblokkeringen van plugin-`before_install`-hooks en omzeilt **niet** scanfouten. Deze CLI-vlag is van toepassing op plugin-installatie-/updateflows. Gateway-ondersteunde installaties van Skills-afhankelijkheden gebruiken de overeenkomende aanvraagoverride `dangerouslyForceUnsafeInstall`, terwijl `openclaw skills install` een aparte download-/installatieflow voor ClawHub-Skills blijft. Als een plugin die je op ClawHub hebt gepubliceerd wordt geblokkeerd door een registryscan, gebruik dan de publicatiestappen in [ClawHub](/nl/clawhub/security). `plugins install` is ook het installatieoppervlak voor hook-packs die `openclaw.hooks` in `package.json` blootstellen. Gebruik `openclaw hooks` voor gefilterde hook-zichtbaarheid en inschakeling per hook, niet voor pakketinstallatie. Npm-specs zijn **alleen registry** (pakketnaam + optioneel **exacte versie** of **dist-tag**). Git-/URL-/bestandsspecs en semver-bereiken worden geweigerd. Afhankelijkheidsinstallaties worden projectlokaal uitgevoerd met `--ignore-scripts` voor veiligheid, zelfs wanneer je shell globale npm-installatie-instellingen heeft. Beheerde npm-roots voor plugins erven de npm-`overrides` op pakketniveau van OpenClaw, zodat beveiligingspins van de host ook van toepassing zijn op gehesen plugin-afhankelijkheden. Gebruik `npm:` wanneer je npm-resolutie expliciet wilt maken. Kale pakketspecs installeren tijdens de lanceringsomschakeling ook rechtstreeks vanaf npm. Kale specs en `@latest` blijven op het stabiele spoor. Datumgestempelde correctieversies van OpenClaw zoals `2026.5.3-1` zijn stabiele releases voor deze controle. Als npm een van deze naar een prerelease resolveert, stopt OpenClaw en vraagt het je expliciet in te stemmen met een prerelease-tag zoals `@beta`/`@rc` of een exacte prereleaseversie zoals `@1.2.3-beta.4`. Als een kale installatiespec overeenkomt met een officiële plugin-id (bijvoorbeeld `diffs`), installeert OpenClaw de catalogusvermelding rechtstreeks. Gebruik een expliciete scoped spec (bijvoorbeeld `@scope/diffs`) om een npm-pakket met dezelfde naam te installeren. Gebruik `git:` om rechtstreeks vanuit een git-repository te installeren. Ondersteunde vormen zijn onder meer `git:github.com/owner/repo`, `git:owner/repo`, volledige `https://`-, `ssh://`-, `git://`-, `file://`- en `git@host:owner/repo.git`-clone-URL's. Voeg `@` of `#` toe om vóór installatie een branch, tag of commit uit te checken. Git-installaties clonen naar een tijdelijke directory, checken de gevraagde ref uit wanneer die aanwezig is, en gebruiken daarna de normale installer voor plugin-directory's. Dat betekent dat manifestvalidatie, scanning op gevaarlijke code, installatiewerk van de package manager en installatierecords zich gedragen als npm-installaties. Vastgelegde git-installaties bevatten de bron-URL/ref plus de opgeloste commit, zodat `openclaw plugins update` de bron later opnieuw kan resolven. Gebruik na installatie vanuit git `openclaw plugins inspect --runtime --json` om runtimeregistraties zoals gateway-methoden en CLI-opdrachten te verifiëren. Als de plugin een CLI-root heeft geregistreerd met `api.registerCli`, voer die opdracht dan rechtstreeks uit via de OpenClaw-root-CLI, bijvoorbeeld `openclaw demo-plugin ping`. Ondersteunde archieven: `.zip`, `.tgz`, `.tar.gz`, `.tar`. Native OpenClaw-pluginarchieven moeten een geldige `openclaw.plugin.json` bevatten in de uitgepakte plugin-root; archieven die alleen `package.json` bevatten, worden geweigerd voordat OpenClaw installatierecords schrijft. Gebruik `npm-pack:` wanneer het bestand een npm-pack-tarball is en je hetzelfde beheerde npm-root-installatiepad wilt testen dat door registry-installaties wordt gebruikt, inclusief `package-lock.json`-verificatie, scanning van gehesen afhankelijkheden en npm-installatierecords. Gewone archiefpaden installeren nog steeds als lokale archieven onder de plugin-extensiesroot. Claude marketplace-installaties worden ook ondersteund. ClawHub-installaties gebruiken een expliciete `clawhub:`-locator: ```bash openclaw plugins install clawhub:openclaw-codex-app-server openclaw plugins install clawhub:openclaw-codex-app-server@1.2.3 ``` Kale npm-veilige plugin-specs installeren tijdens de lanceringsomschakeling standaard vanaf npm: ```bash openclaw plugins install openclaw-codex-app-server ``` Gebruik `npm:` om npm-only-resolutie expliciet te maken: ```bash openclaw plugins install npm:openclaw-codex-app-server openclaw plugins install npm:@scope/plugin-name@1.0.1 ``` OpenClaw controleert de geadverteerde Plugin API / minimale Gateway-compatibiliteit vóór installatie. Wanneer de geselecteerde ClawHub-versie een ClawPack-artefact publiceert, downloadt OpenClaw de versiegebonden npm-pack `.tgz`, verifieert het de ClawHub-digestheader en de artefact-digest, en installeert het dit vervolgens via het normale archiefpad. Oudere ClawHub-versies zonder ClawPack-metadata installeren nog steeds via het legacy-verificatiepad voor pakketarchieven. Vastgelegde installaties bewaren hun ClawHub-bronmetadata, artefactsoort, npm-integriteit, npm-shasum, tarballnaam en ClawPack-digestgegevens voor latere updates. Niet-geversioneerde ClawHub-installaties bewaren een niet-geversioneerde vastgelegde spec zodat `openclaw plugins update` nieuwere ClawHub-releases kan volgen; expliciete versie- of tagselectoren zoals `clawhub:pkg@1.2.3` en `clawhub:pkg@beta` blijven aan die selector vastgepind. #### Marketplace-shorthand Gebruik `plugin@marketplace`-shorthand wanneer de marketplace-naam bestaat in Claude's lokale registry-cache op `~/.claude/plugins/known_marketplaces.json`: ```bash openclaw plugins marketplace list openclaw plugins install @ ``` Gebruik `--marketplace` wanneer je de marketplace-bron expliciet wilt doorgeven: ```bash openclaw plugins install --marketplace openclaw plugins install --marketplace openclaw plugins install --marketplace https://github.com// openclaw plugins install --marketplace ./my-marketplace ``` - een Claude bekende-marketplace-naam uit `~/.claude/plugins/known_marketplaces.json` - een lokale marketplace-root of `marketplace.json`-pad - een GitHub-repo-shorthand zoals `owner/repo` - een GitHub-repo-URL zoals `https://github.com/owner/repo` - een git-URL Voor externe marketplaces die vanaf GitHub of git worden geladen, moeten Plugin-vermeldingen binnen de gekloonde marketplace-repo blijven. OpenClaw accepteert relatieve padbronnen uit die repo en weigert HTTP(S), absolute paden, git, GitHub en andere niet-pad-Plugin-bronnen uit externe manifests. Voor lokale paden en archieven detecteert OpenClaw automatisch: - native OpenClaw-Plugins (`openclaw.plugin.json`) - Codex-compatibele bundels (`.codex-plugin/plugin.json`) - Claude-compatibele bundels (`.claude-plugin/plugin.json` of de standaard Claude-componentindeling) - Cursor-compatibele bundels (`.cursor-plugin/plugin.json`) Compatibele bundels installeren in de normale Plugin-root en nemen deel aan dezelfde list/info/enable/disable-flow. Op dit moment worden bundel-Skills, Claude command-Skills, Claude `settings.json`-standaarden, Claude `.lsp.json` / door manifest gedeclareerde `lspServers`-standaarden, Cursor command-Skills en compatibele Codex-hookmappen ondersteund; andere gedetecteerde bundelmogelijkheden worden getoond in diagnostics/info, maar zijn nog niet aangesloten op runtime-uitvoering. ### Lijst ```bash openclaw plugins list openclaw plugins list --enabled openclaw plugins list --verbose openclaw plugins list --json openclaw plugins search openclaw plugins search --limit 20 openclaw plugins search --json ``` Toon alleen ingeschakelde Plugins. Schakel over van de tabelweergave naar detailregels per Plugin met metadata over bron/herkomst/versie/activering. Machineleesbare inventaris plus registry-diagnostics en installatiestatus van pakketafhankelijkheden. `plugins list` leest eerst de blijvend opgeslagen lokale Plugin-registry, met een alleen-van-manifest-afgeleide fallback wanneer de registry ontbreekt of ongeldig is. Dit is nuttig om te controleren of een Plugin is geïnstalleerd, ingeschakeld en zichtbaar is voor planning bij een koude start, maar het is geen live runtime-probe van een al draaiend Gateway-proces. Start na het wijzigen van Plugin-code, inschakeling, hookbeleid of `plugins.load.paths` de Gateway opnieuw die het kanaal bedient voordat je verwacht dat nieuwe `register(api)`-code of hooks worden uitgevoerd. Controleer bij externe/containerdeployments of je het daadwerkelijke `openclaw gateway run`-child opnieuw start, niet alleen een wrapperproces. `plugins list --json` bevat voor elke Plugin de `dependencyStatus` uit `package.json` `dependencies` en `optionalDependencies`. OpenClaw controleert of die pakketnamen aanwezig zijn langs het normale Node `node_modules`-opzoekpad van de Plugin; het importeert geen Plugin-runtimecode, voert geen pakketbeheerder uit en repareert ontbrekende afhankelijkheden niet. `plugins search` is een externe ClawHub-cataloguslookup. Het inspecteert geen lokale staat, wijzigt geen configuratie, installeert geen pakketten en laadt geen Plugin-runtimecode. Zoekresultaten bevatten de ClawHub-pakketnaam, familie, kanaal, versie, samenvatting en een installatiehint zoals `openclaw plugins install clawhub:`. Voor gebundeld Plugin-werk binnen een verpakte Docker-image bind-mount je de Plugin- bronmap over het overeenkomende verpakte bronpad, zoals `/app/extensions/synology-chat`. OpenClaw ontdekt die gemounte bron- overlay vóór `/app/dist/extensions/synology-chat`; een gewone gekopieerde bronmap blijft inert, zodat normale verpakte installaties nog steeds de gecompileerde dist gebruiken. Voor runtime-hookdebugging: - `openclaw plugins inspect --runtime --json` toont geregistreerde hooks en diagnostics uit een module-geladen inspectiepass. Runtime-inspectie installeert nooit afhankelijkheden; gebruik `openclaw doctor --fix` om legacy-afhankelijkheidsstatus op te schonen of ontbrekende downloadbare Plugins te herstellen waarnaar in configuratie wordt verwezen. - `openclaw gateway status --deep --require-rpc` bevestigt de bereikbare Gateway, service/proces-hints, configuratiepad en RPC-gezondheid. - Niet-gebundelde conversation hooks (`llm_input`, `llm_output`, `before_model_resolve`, `before_agent_reply`, `before_agent_run`, `before_agent_finalize`, `agent_end`) vereisen `plugins.entries..hooks.allowConversationAccess=true`. Gebruik `--link` om het kopiëren van een lokale map te vermijden (voegt toe aan `plugins.load.paths`): ```bash openclaw plugins install -l ./my-plugin ``` `--force` wordt niet ondersteund met `--link`, omdat gelinkte installaties het bronpad hergebruiken in plaats van over een beheerd installatiedoel heen te kopiëren. Gebruik `--pin` bij npm-installaties om de opgeloste exacte spec (`name@version`) in de beheerde Plugin-index op te slaan terwijl het standaardgedrag niet-vastgepind blijft. ### Plugin-index Installatiemetadata van Plugins is machinebeheerde staat, geen gebruikersconfiguratie. Installaties en updates schrijven deze naar `plugins/installs.json` onder de actieve OpenClaw-statusmap. De top-level `installRecords`-map is de duurzame bron van installatiemetadata, inclusief records voor kapotte of ontbrekende Plugin-manifests. De `plugins`-array is de van manifest afgeleide koude registry-cache. Het bestand bevat een waarschuwing om het niet te bewerken en wordt gebruikt door `openclaw plugins update`, uninstall, diagnostics en de koude Plugin-registry. Wanneer OpenClaw meegeleverde legacy `plugins.installs`-records in configuratie ziet, behandelen runtime-lezingen ze als compatibiliteitsinvoer zonder `openclaw.json` te herschrijven. Expliciete Plugin-schrijfacties en `openclaw doctor --fix` verplaatsen die records naar de Plugin-index en verwijderen de configuratiesleutel wanneer configuratieschrijfacties zijn toegestaan; als een van beide schrijfacties mislukt, blijven de configuratierecords behouden zodat de installatiemetadata niet verloren gaat. ### De-installeren ```bash openclaw plugins uninstall openclaw plugins uninstall --dry-run openclaw plugins uninstall --keep-files ``` `uninstall` verwijdert Plugin-records uit `plugins.entries`, de blijvend opgeslagen Plugin-index, Plugin-allow/deny-listvermeldingen en gelinkte `plugins.load.paths`-vermeldingen waar van toepassing. Tenzij `--keep-files` is ingesteld, verwijdert uninstall ook de bijgehouden beheerde installatiemap wanneer die zich binnen OpenClaw's Plugin-extensions-root bevindt. Voor Active Memory-Plugins wordt het geheugenslot teruggezet naar `memory-core`. `--keep-config` wordt ondersteund als verouderd alias voor `--keep-files`. ### Bijwerken ```bash openclaw plugins update openclaw plugins update --all openclaw plugins update --dry-run openclaw plugins update @openclaw/voice-call openclaw plugins update openclaw-codex-app-server --dangerously-force-unsafe-install ``` Updates zijn van toepassing op bijgehouden Plugin-installaties in de beheerde Plugin-index en bijgehouden hook-pack-installaties in `hooks.internal.installs`. Wanneer je een Plugin-id doorgeeft, hergebruikt OpenClaw de vastgelegde installatiespec voor die Plugin. Dat betekent dat eerder opgeslagen dist-tags zoals `@beta` en exacte vastgepinde versies bij latere `update `-runs gebruikt blijven worden. Voor npm-installaties kun je ook een expliciete npm-pakketspec met een dist-tag of exacte versie doorgeven. OpenClaw lost die pakketnaam terug op naar het bijgehouden Plugin-record, werkt die geïnstalleerde Plugin bij en legt de nieuwe npm-spec vast voor toekomstige id-gebaseerde updates. Het doorgeven van de npm-pakketnaam zonder versie of tag lost ook terug op naar het bijgehouden Plugin-record. Gebruik dit wanneer een Plugin was vastgepind op een exacte versie en je deze terug wilt verplaatsen naar de standaard releaselijn van de registry. `openclaw plugins update` hergebruikt de bijgehouden Plugin-spec tenzij je een nieuwe spec doorgeeft. `openclaw update` kent daarnaast het actieve OpenClaw-updatekanaal: op het bètakanaal proberen npm- en ClawHub-Plugin-records op de standaardlijn eerst `@beta` en vallen daarna terug op de vastgelegde default/latest-spec als er geen Plugin-bètarelease bestaat. Die fallback wordt als waarschuwing gemeld en laat de core-update niet mislukken. Exacte versies en expliciete tags blijven aan die selector vastgepind. Vóór een live npm-update controleert OpenClaw de geïnstalleerde pakketversie tegen de metadata van de npm-registry. Als de geïnstalleerde versie en vastgelegde artefactidentiteit al overeenkomen met het opgeloste doel, wordt de update overgeslagen zonder te downloaden, opnieuw te installeren of `openclaw.json` te herschrijven. Wanneer een opgeslagen integrity-hash bestaat en de opgehaalde artefacthash verandert, behandelt OpenClaw dat als npm-artefactdrift. De interactieve opdracht `openclaw plugins update` drukt de verwachte en werkelijke hashes af en vraagt om bevestiging voordat wordt doorgegaan. Niet-interactieve updatehelpers falen gesloten tenzij de aanroeper een expliciet voortzettingsbeleid aanlevert. `--dangerously-force-unsafe-install` is ook beschikbaar bij `plugins update` als noodoverride voor foutpositieven in de ingebouwde dangerous-code-scan tijdens Plugin-updates. Het omzeilt nog steeds geen Plugin-`before_install`-beleidsblokkades of blokkering door scanfouten, en het is alleen van toepassing op Plugin-updates, niet op hook-pack-updates. ### Inspecteren ```bash openclaw plugins inspect openclaw plugins inspect --runtime openclaw plugins inspect --json ``` Inspect toont identiteit, laadstatus, bron, manifestmogelijkheden, beleidsvlaggen, diagnostics, installatiemetadata, bundelmogelijkheden en eventueel gedetecteerde MCP- of LSP-serverondersteuning zonder standaard Plugin-runtime te importeren. Voeg `--runtime` toe om de Plugin-module te laden en geregistreerde hooks, tools, commands, services, gateway methods en HTTP-routes op te nemen. Runtime-inspectie meldt ontbrekende Plugin-afhankelijkheden rechtstreeks; installaties en reparaties blijven in `openclaw plugins install`, `openclaw plugins update` en `openclaw doctor --fix`. CLI-opdrachten die eigendom zijn van een Plugin worden meestal geïnstalleerd als root-`openclaw`-opdrachtgroepen, maar Plugins kunnen ook geneste opdrachten registreren onder een core-parent zoals `openclaw nodes`. Nadat `inspect --runtime` een opdracht onder `cliCommands` toont, voer je deze uit op het vermelde pad; bijvoorbeeld: een Plugin die `demo-git` registreert, kan worden geverifieerd met `openclaw demo-git ping`. Elke Plugin wordt geclassificeerd op basis van wat deze daadwerkelijk tijdens runtime registreert: - **gewone-capability** — één capabilitytype (bijv. een Plugin die alleen provider is) - **hybride-capability** — meerdere capabilitytypen (bijv. tekst + spraak + afbeeldingen) - **alleen-hook** — alleen hooks, geen capabilities of oppervlakken - **niet-capability** — tools/opdrachten/services maar geen capabilities Zie [Plugin-vormen](/nl/plugins/architecture#plugin-shapes) voor meer over het capabilitymodel. De vlag `--json` voert een machineleesbaar rapport uit dat geschikt is voor scripting en audits. `inspect --all` rendert een vlootbrede tabel met kolommen voor vorm, capabilitytypen, compatibiliteitsmeldingen, bundelcapabilities en hooksamenvatting. `info` is een alias voor `inspect`. ### Doctor ```bash openclaw plugins doctor ``` `doctor` rapporteert laadfouten van Plugins, manifest-/discoverydiagnostiek en compatibiliteitsmeldingen. Als alles schoon is, drukt het `No plugin issues detected.` af. Als een geconfigureerde Plugin op schijf aanwezig is maar wordt geblokkeerd door de padveiligheidscontroles van de loader, behoudt configvalidatie de Plugin-vermelding en rapporteert deze als `present but blocked`. Los de voorafgaande diagnostiek voor de geblokkeerde Plugin op, zoals padeigendom of wereldwijd schrijfbare machtigingen, in plaats van de configuratie `plugins.entries.` of `plugins.allow` te verwijderen. Voor modulevormfouten zoals ontbrekende `register`-/`activate`-exports, voer opnieuw uit met `OPENCLAW_PLUGIN_LOAD_DEBUG=1` om een compacte samenvatting van de exportvorm in de diagnostische uitvoer op te nemen. ### Registry ```bash openclaw plugins registry openclaw plugins registry --refresh openclaw plugins registry --json ``` De lokale Plugin-registry is OpenClaw's blijvend opgeslagen model voor koude reads voor geïnstalleerde Plugin-identiteit, inschakeling, bronmetadata en eigenaarschap van bijdragen. Normaal opstarten, provider-eigenaarsopzoekingen, classificatie van kanaalinstellingen en Plugin-inventaris kunnen dit lezen zonder Plugin-runtime-modules te importeren. Gebruik `plugins registry` om te controleren of de blijvend opgeslagen registry aanwezig, actueel of verouderd is. Gebruik `--refresh` om deze opnieuw op te bouwen vanuit de blijvend opgeslagen Plugin-index, het configuratiebeleid en manifest-/pakketmetadata. Dit is een herstelpad, geen runtime-activeringspad. `openclaw doctor --fix` herstelt ook registry-aangrenzende beheerde npm-drift: als een verweesd of hersteld `@openclaw/*`-pakket onder de beheerde Plugin-npm-root een gebundelde Plugin overschaduwt, verwijdert doctor dat verouderde pakket en bouwt de registry opnieuw op zodat opstarten valideert tegen het gebundelde manifest. Doctor koppelt ook het hostpakket `openclaw` opnieuw aan beheerde npm-Plugins die `peerDependencies.openclaw` declareren, zodat pakketlokale runtime-imports zoals `openclaw/plugin-sdk/*` na updates of npm-reparaties worden opgelost. `OPENCLAW_DISABLE_PERSISTED_PLUGIN_REGISTRY=1` is een verouderde break-glass-compatibiliteitsschakelaar voor leesfouten van de registry. Geef de voorkeur aan `plugins registry --refresh` of `openclaw doctor --fix`; de env-fallback is alleen voor noodherstel van opstarten terwijl de migratie wordt uitgerold. ### Marketplace ```bash openclaw plugins marketplace list openclaw plugins marketplace list --json ``` Marketplace list accepteert een lokaal marketplace-pad, een `marketplace.json`-pad, een GitHub-shorthand zoals `owner/repo`, een GitHub-repo-URL of een git-URL. `--json` drukt het opgeloste bronlabel af plus het geparste marketplace-manifest en de Plugin-vermeldingen. ## Gerelateerd - [Plugins bouwen](/nl/plugins/building-plugins) - [CLI-referentie](/nl/cli) - [ClawHub](/nl/clawhub)