openclaw plugins.
La maggior parte dei flussi di installazione è:
- trovare un pacchetto
- installarlo da ClawHub, npm, git o da un percorso locale
- lasciare che il Gateway gestito si riavvii automaticamente, oppure riavviarlo manualmente quando non è gestito
- verificare le registrazioni runtime del plugin
Elencare e cercare plugin
--json per gli script:
plugins list è un controllo a freddo dell’inventario. Mostra ciò che OpenClaw può individuare da configurazione, manifest e registro dei plugin; non prova che un Gateway già in esecuzione abbia importato il runtime del plugin. L’output JSON include diagnostica del registro e il dependencyStatus statico di ciascun plugin quando il pacchetto del plugin dichiara dependencies o optionalDependencies.
plugins search interroga ClawHub per pacchetti di plugin installabili e stampa suggerimenti di installazione come openclaw plugins install clawhub:<package>.
Installare plugin
clawhub:, npm:, git: o npm-pack: quando ti serve una selezione deterministica della sorgente. Se il nome senza prefisso corrisponde a un ID di plugin ufficiale, OpenClaw può installare direttamente la voce del catalogo.
Usa --force solo quando vuoi intenzionalmente sovrascrivere una destinazione di installazione esistente. Per gli aggiornamenti ordinari di installazioni tracciate npm, ClawHub o hook-pack, usa openclaw plugins update.
Riavviare e ispezionare
Dopo aver installato, aggiornato o disinstallato codice di plugin, un Gateway gestito in esecuzione con ricaricamento della configurazione abilitato si riavvia automaticamente. Se il Gateway non è gestito o il ricaricamento è disabilitato, riavvialo tu prima di controllare le superfici runtime live:inspect --runtime quando ti serve la prova che il plugin abbia registrato superfici runtime come strumenti, hook, servizi, metodi del Gateway, route HTTP o comandi CLI di proprietà del plugin. inspect semplice e list sono controlli a freddo di manifest, configurazione e registro.
Aggiornare plugin
@beta e le versioni esatte fissate continuano a essere usati nelle esecuzioni successive di update <plugin-id>.
openclaw plugins update --all è il percorso di manutenzione in blocco. Rispetta comunque le normali specifiche di installazione tracciate, ma i record attendibili dei plugin ufficiali OpenClaw possono sincronizzarsi con la destinazione corrente del catalogo ufficiale invece di restare su un pacchetto ufficiale esatto obsoleto. Se update.channel è impostato su beta, quella sincronizzazione ufficiale in blocco usa il contesto del canale beta. Usa un update <plugin-id> mirato quando vuoi intenzionalmente mantenere intatta una specifica ufficiale esatta o con tag.
Per le installazioni npm, puoi passare una specifica di pacchetto esplicita per cambiare il record tracciato:
openclaw update viene eseguito sul canale beta, i record dei plugin possono preferire rilasci @beta corrispondenti. Per le regole esatte di fallback e pinning, vedi
openclaw plugins.
Disinstallare plugin
--keep-files. Un Gateway gestito in esecuzione si riavvia automaticamente quando la disinstallazione cambia la sorgente del plugin.
In modalità Nix (OPENCLAW_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.
Scegliere una sorgente
| Sorgente | Usare quando | Esempio |
|---|---|---|
| ClawHub | Vuoi discovery nativa OpenClaw, riepiloghi di scansione, versioni e suggerimenti | openclaw plugins install clawhub:<package> |
| npmjs.com | Distribuisci già pacchetti JavaScript o ti servono dist-tag npm/registro privato | openclaw plugins install npm:@acme/openclaw-plugin |
| git | Vuoi un branch, un tag o un commit da un repository | openclaw plugins install git:github.com/<owner>/<repo>@<ref> |
| percorso locale | Stai sviluppando o testando un plugin sulla stessa macchina | openclaw plugins install --link ./my-plugin |
| npm pack | Stai verificando un artifact di pacchetto locale tramite la semantica di installazione npm | openclaw plugins install npm-pack:<path.tgz> |
| marketplace | Stai installando un plugin marketplace compatibile con Claude | openclaw plugins install <plugin> --marketplace <source> |
plugins.load.paths invece di installarli con plugins install.
Pubblicare plugin
ClawHub è la principale superficie pubblica di discovery per i plugin OpenClaw. Pubblica lì quando vuoi che gli utenti trovino metadati del plugin, cronologia delle versioni, risultati di scansione del registro e suggerimenti di installazione prima di installare.package.json
- Pubblicazione ClawHub spiega proprietari, ambiti, rilasci, revisione, convalida dei pacchetti e trasferimento dei pacchetti.
- Creare plugin mostra la struttura del pacchetto del plugin e il primo flusso di pubblicazione.
- Manifest del plugin definisce i campi del manifest dei plugin nativi.
clawhub: o npm: quando devi forzare una sorgente.
Correlati
- Plugin - installazione, configurazione, riavvio e risoluzione dei problemi
openclaw plugins- riferimento CLI completo- Plugin della community - discovery pubblica e pubblicazione su ClawHub
- ClawHub - operazioni CLI del registro
- Creare plugin - creare un pacchetto di plugin
- Manifest del plugin - manifest e metadati del pacchetto