Gestire i plugin

L'interfaccia di controllo copre il flusso di lavoro comune di individuazione, installazione, abilitazione e disabilitazione. La CLI aggiunge aggiornamento, disinstallazione, configurazione avanzata e controlli espliciti sull'origine di installazione. Per il contratto completo dei comandi, i flag, le regole di selezione dell'origine e i casi limite, consulta openclaw plugins.

Flusso di lavoro tipico della CLI: trova un pacchetto, installalo da ClawHub, npm, git o da un percorso locale, lascia che il Gateway gestito si riavvii automaticamente (oppure riavvialo manualmente), quindi verifica le registrazioni di runtime del plugin.

Usa l'interfaccia di controllo

Apri Plugin nell'interfaccia di controllo oppure usa /settings/plugins rispetto al percorso di base configurato per l'interfaccia di controllo. Ad esempio, un percorso di base /openclaw usa /openclaw/settings/plugins. La pagina contiene due schede:

• Installati mostra l'inventario locale completo raggruppato per categoria (canali, provider di modelli, memoria, strumenti). Ogni riga apre una vista dettagliata; il relativo menu di overflow (…) abilita o disabilita il plugin e, per i plugin installati esternamente, offre Rimuovi. La scheda elenca anche i server MCP configurati con le stesse azioni di abilitazione, disabilitazione e rimozione basate su menu, modificando mcp.servers nella configurazione del Gateway.
• Scopri è lo store: plugin in evidenza inclusi con OpenClaw, plugin esterni ufficiali e una raccolta selezionata di connettori. Le schede dei connettori aggiungono con un clic un server MCP ospitato (GitHub, Notion, Linear, Sentry, Home Assistant) oppure aprono una ricerca ClawHub precompilata. Digitando nella casella di ricerca viene eseguita direttamente una query su ClawHub e viene aggiunta una sezione Da ClawHub con conteggi dei download e badge di verifica dell'origine.

I plugin inclusi non richiedono l'installazione di un pacchetto. La relativa azione di menu è Abilita o Disabilita. Workboard, ad esempio, è incluso con OpenClaw e disabilitato per impostazione predefinita, quindi scegli Abilita per attivarlo. I plugin forniti in bundle non possono essere rimossi, ma solo disabilitati.

L'accesso al catalogo e alla ricerca richiede operator.read. L'installazione, l'abilitazione, la disabilitazione, la rimozione e le modifiche ai server MCP richiedono operator.admin. Un'installazione da ClawHub viene eseguita dal Gateway e mantiene i relativi controlli di attendibilità, integrità e criteri di installazione dei plugin.

L'installazione o la rimozione del codice di un plugin richiede il riavvio del Gateway. Le modifiche all'abilitazione possono essere applicate senza riavvio quando il plugin installato e il runtime corrente del Gateway lo supportano; in caso contrario, l'interfaccia indica che è necessario un riavvio. I connettori MCP basati su OAuth richiedono comunque l'esecuzione una tantum di openclaw mcp login <name> dalla CLI dopo essere stati aggiunti.

L'interfaccia di controllo non installa da origini npm, git o percorsi locali arbitrari, non aggiorna i plugin e non espone una configurazione avanzata dei plugin. Per queste operazioni, usa i flussi di lavoro della CLI riportati di seguito.

Elencare e cercare i plugin

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

--json per gli script:

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

plugins list è un controllo a freddo dell'inventario: indica ciò che OpenClaw può individuare dalla configurazione, dai manifest e dal registro persistente dei plugin. Non dimostra che un Gateway già in esecuzione abbia importato il runtime del plugin. L'output JSON include la diagnostica del registro e il dependencyStatus di ciascun plugin, che indica se le dependencies/optionalDependencies dichiarate sono risolvibili su disco.

plugins search interroga ClawHub per trovare pacchetti di plugin installabili e visualizza per ogni risultato un suggerimento di installazione (openclaw plugins install clawhub:<package>).

Abilitare e disabilitare i plugin

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

Modifica la voce di configurazione di un plugin senza intervenire sui file installati. Alcuni plugin forniti in bundle (provider di modelli e sintesi vocale in bundle e il plugin del browser in bundle) sono abilitati per impostazione predefinita; altri richiedono enable dopo l'installazione.

Installare i plugin

# Cerca pacchetti di plugin su ClawHub.openclaw plugins search "calendar" # Installa da ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Installa da npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/openclaw-plugin@1.2.3openclaw plugins install npm:@openclaw/codex # Installa da un artefatto locale prodotto da npm pack.openclaw plugins install npm-pack:<path.tgz> # Installa da git o da un checkout di sviluppo locale.openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

Durante il passaggio definitivo all'avvio, le specifiche di pacchetto senza prefisso vengono installate da npm, a meno che il nome non corrisponda all'ID di un plugin fornito in bundle o ufficiale; in tal caso, OpenClaw usa invece la copia locale/ufficiale. Usa clawhub:, npm:, git: o npm-pack: per una selezione deterministica dell'origine.

Usa --force solo per sovrascrivere una destinazione di installazione esistente proveniente da un'origine diversa. Per gli aggiornamenti ordinari di un'installazione npm, ClawHub o di un pacchetto di hook registrata, usa invece openclaw plugins update; --force non è supportato con --link.

Riavviare e ispezionare

Un Gateway gestito in esecuzione con il ricaricamento della configurazione abilitato si riavvia automaticamente dopo l'installazione, l'aggiornamento o la disinstallazione del codice di un plugin. Se il Gateway non è gestito o il ricaricamento è disabilitato, riavvialo manualmente prima di controllare le superfici di runtime attive:

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

inspect --runtime carica il modulo del plugin e dimostra che ha registrato superfici di runtime (strumenti, hook, servizi, metodi del Gateway, route HTTP, comandi CLI di proprietà del plugin). inspect senza opzioni e list eseguono solo controlli a freddo di manifest, configurazione e registro.

Aggiornare i plugin

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

Il passaggio dell'ID di un plugin riutilizza la relativa specifica di installazione registrata: i dist-tag memorizzati (@beta) e le versioni esatte bloccate vengono mantenuti nelle successive esecuzioni di update <plugin-id>.

openclaw plugins update --all è il percorso di manutenzione in blocco. Continua a rispettare le normali specifiche di installazione registrate, ma i record attendibili dei plugin ufficiali OpenClaw vengono sincronizzati con la destinazione corrente del catalogo ufficiale invece di rimanere bloccati su un pacchetto ufficiale esatto obsoleto; quando update.channel è beta, la sincronizzazione preferisce la linea di rilascio beta. Usa un comando mirato update <plugin-id> per mantenere invariata una specifica ufficiale esatta o con tag.

Per le installazioni npm, passa una specifica esplicita del pacchetto per modificare il record registrato:

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

Il secondo comando riporta un plugin alla linea di rilascio predefinita del registro quando in precedenza era bloccato su una versione esatta o un tag.

Consulta openclaw plugins per le regole esatte di ripiego e blocco delle versioni.

Disinstallare i plugin

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

La disinstallazione rimuove la voce di configurazione del plugin, il record persistente dell'indice dei plugin, le voci degli elenchi di autorizzazione/blocco e, quando applicabile, le voci collegate di plugins.load.paths. La directory di installazione gestita viene rimossa, a meno che non venga passato --keep-files. Un Gateway gestito in esecuzione si riavvia automaticamente quando la disinstallazione modifica l'origine del plugin.

In modalità Nix (OPENCLAW_NIX_MODE=1), l'installazione, l'aggiornamento, la disinstallazione, l'abilitazione e la disabilitazione dei plugin sono tutti disabilitati; gestisci queste scelte nell'origine Nix dell'installazione.

Scegliere un'origine

Le installazioni gestite da percorso locale devono essere directory o archivi di plugin. Inserisci i file di plugin autonomi in plugins.load.paths invece di installarli con plugins install.

Pubblicare i plugin

ClawHub è la principale superficie pubblica di individuazione per i plugin OpenClaw. Pubblica lì quando vuoi che gli utenti trovino i metadati del plugin, la cronologia delle versioni, i risultati delle scansioni del registro e i suggerimenti di installazione prima di installarlo.

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/your-plugin@v1.0.0

Prima della pubblicazione, i plugin npm nativi devono includere un manifest del plugin (openclaw.plugin.json) e i metadati di package.json:

{  "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/openclaw-plugin@1.0.0

Per il contratto completo di pubblicazione, usa queste pagine invece di considerare questa pagina come riferimento per la pubblicazione:

• Pubblicazione su ClawHub spiega proprietari, ambiti, rilasci, revisione, convalida e trasferimento dei pacchetti.
• Creazione di plugin mostra la struttura completa del pacchetto del plugin (incluso openclaw.plugin.json) e il flusso di lavoro per la prima pubblicazione.
• Manifest del plugin definisce i campi del manifest dei plugin nativi.

Se lo stesso pacchetto è disponibile sia su ClawHub sia su npm, usa il prefisso esplicito clawhub: o npm: per imporre un'origine.

Risorse correlate

• Plugin - installazione, configurazione, riavvio e risoluzione dei problemi
• openclaw plugins - riferimento completo della CLI
• Plugin della community - individuazione pubblica e pubblicazione su ClawHub
• ClawHub - operazioni della CLI del registro
• Creazione di plugin - creazione di un pacchetto plugin
• Manifest del plugin - manifest e metadati del pacchetto