Gestire i Plugin

La maggior parte dei flussi di lavoro dei Plugin richiede pochi comandi: cercare, installare, riavviare il Gateway, verificare e disinstallare quando il Plugin non serve piu.

Elenca i Plugin

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

Usa --json per gli script. Include la diagnostica del registro e il dependencyStatus statico di ciascun Plugin quando il pacchetto del Plugin dichiara dependencies o optionalDependencies.

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

plugins list e un controllo di inventario a freddo. Mostra cio che OmeniaClaw puo scoprire dalla configurazione, dai manifest e dal registro dei Plugin; non dimostra che un processo Gateway gia in esecuzione abbia importato il runtime del Plugin.

Installa i Plugin

# 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

Dopo aver installato il codice del Plugin, riavvia il Gateway che serve i tuoi canali:

OmeniaClaw gateway restartOmeniaClaw plugins inspect <plugin-id> --runtime --json

Usa inspect --runtime quando ti serve una prova che il Plugin abbia registrato superfici runtime come strumenti, hook, servizi, metodi Gateway o comandi CLI di proprieta del Plugin.

Aggiorna i Plugin

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

Se un Plugin e stato installato da un dist-tag npm come @beta, le successive chiamate update <plugin-id> riutilizzano quel tag registrato. Passare una specifica npm esplicita sposta l'installazione tracciata su quella specifica per gli aggiornamenti futuri.

OmeniaClaw plugins update @scope/OmeniaClaw-plugin@betaOmeniaClaw plugins update @scope/OmeniaClaw-plugin

Il secondo comando riporta un Plugin alla linea di rilascio predefinita del registro quando era stato precedentemente fissato a una versione esatta o a un tag.

Quando OmeniaClaw update viene eseguito sul canale beta, i record dei Plugin npm e ClawHub della linea predefinita provano prima la release @beta del Plugin corrispondente. Se quella release beta non esiste, OmeniaClaw torna alla specifica predefinita/latest registrata. Per i Plugin npm, OmeniaClaw torna indietro anche quando il pacchetto beta esiste ma non supera la validazione dell'installazione. Le versioni esatte e i tag espliciti come @rc o @beta vengono preservati.

Disinstalla i Plugin

OmeniaClaw plugins uninstall <plugin-id> --dry-runOmeniaClaw plugins uninstall <plugin-id>OmeniaClaw plugins uninstall <plugin-id> --keep-filesOmeniaClaw gateway restart

La disinstallazione rimuove la voce di configurazione del Plugin, il record dell'indice dei Plugin, le voci delle liste allow/deny e, quando applicabile, i percorsi di caricamento collegati. Le directory di installazione gestite vengono rimosse a meno che non passi --keep-files.

In modalita Nix (OmeniaClaw_NIX_MODE=1), i comandi di installazione, aggiornamento, disinstallazione, abilitazione e disabilitazione dei Plugin sono disabilitati. Gestisci invece queste scelte nella sorgente Nix dell'installazione; per nix-OmeniaClaw, usa la Guida rapida agent-first.

Pubblica i Plugin

Puoi pubblicare Plugin esterni su ClawHub, npmjs.com o entrambi.

Pubblica su ClawHub

ClawHub e la superficie primaria di scoperta pubblica per i Plugin OmeniaClaw. Offre agli utenti metadati ricercabili, cronologia delle versioni e risultati delle scansioni del registro prima dell'installazione.

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]

Gli utenti installano da ClawHub con:

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

La forma senza prefisso controlla comunque prima ClawHub.

Pubblica su npmjs.com

I Plugin npm nativi devono includere un manifest del Plugin e i metadati dell'entrypoint OmeniaClaw in package.json.

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

npm publish --access public

Gli utenti installano solo da npm con:

OmeniaClaw plugins install npm:@acme/OmeniaClaw-pluginOmeniaClaw plugins install npm:@acme/OmeniaClaw-plugin@betaOmeniaClaw plugins install npm:@acme/[email protected]

Se lo stesso pacchetto e disponibile anche su ClawHub, npm: salta la ricerca su ClawHub e forza la risoluzione npm.

Scelta della sorgente

• ClawHub: usalo quando vuoi scoperta nativa OmeniaClaw, riepiloghi delle scansioni, versioni e suggerimenti di installazione.
• npmjs.com: usalo quando distribuisci gia pacchetti JavaScript o hai bisogno di flussi di lavoro con dist-tag/registri privati npm.
• Git: usalo quando vuoi installare direttamente da un branch, un tag o un commit.
• Percorso locale: usalo quando sviluppi o testi un Plugin sulla stessa macchina.

Correlati

• Plugin - panoramica e risoluzione dei problemi
• OmeniaClaw plugins - riferimento CLI completo
• ClawHub - pubblicazione e operazioni sul registro
• Creare Plugin - crea un pacchetto Plugin
• Manifest del Plugin - manifest e metadati del pacchetto