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

OmeniaClaw plugins listOmeniaClaw plugins list --enabledOmeniaClaw plugins list --verboseOmeniaClaw plugins list --json

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

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

plugins list is een koude inventariscontrole. Het toont wat OmeniaClaw 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.OmeniaClaw plugins search "calendar" # Bare package specs try ClawHub first, then npm fallback.OmeniaClaw plugins install <package> # Force one source.OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install npm:<package> # Install a specific version or dist-tag.OmeniaClaw plugins install clawhub:<package>@1.2.3OmeniaClaw plugins install clawhub:<package>@betaOmeniaClaw plugins install npm:@scope/[email protected]OmeniaClaw plugins install npm:@OmeniaClaw/codex # Install from git or a local development checkout.OmeniaClaw plugins install git:github.com/acme/[email protected]OmeniaClaw plugins install ./my-pluginOmeniaClaw plugins install --link ./my-plugin

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

OmeniaClaw gateway restartOmeniaClaw 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

OmeniaClaw plugins update <plugin-id>OmeniaClaw plugins update <npm-package-or-spec>OmeniaClaw 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.

OmeniaClaw plugins update @scope/OmeniaClaw-plugin@betaOmeniaClaw plugins update @scope/OmeniaClaw-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 OmeniaClaw 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 OmeniaClaw terug op de vastgelegde standaard-/laatste specificatie. Voor npm-plugins valt OmeniaClaw 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

OmeniaClaw plugins uninstall <plugin-id> --dry-runOmeniaClaw plugins uninstall <plugin-id>OmeniaClaw plugins uninstall <plugin-id> --keep-filesOmeniaClaw 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 (OmeniaClaw_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-OmeniaClaw 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 OmeniaClaw-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:

OmeniaClaw plugins install clawhub:<package>OmeniaClaw plugins install <package>

De kale vorm controleert nog steeds eerst ClawHub.

Publiceren naar npmjs.com

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

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

npm publish --access public

Gebruikers installeren npm-only met:

OmeniaClaw plugins install npm:@acme/OmeniaClaw-pluginOmeniaClaw plugins install npm:@acme/OmeniaClaw-plugin@betaOmeniaClaw 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 OmeniaClaw-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
• OmeniaClaw plugins - volledige CLI-referentie
• ClawHub - publicatie- en registerbewerkingen
• Plugins bouwen - een pluginpakket maken
• Pluginmanifest - manifest- en pakketmetadata