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 più.

# Elencare i plugin

openclaw plugins list
openclaw plugins list --enabled
openclaw plugins list --verbose
openclaw 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.

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

plugins list è un controllo di inventario a freddo. Mostra cosa OpenClaw può rilevare da configurazione, manifest e registro dei plugin; non dimostra che un processo Gateway già in esecuzione abbia importato il runtime del plugin.

# Installare i plugin

# Search ClawHub for plugin packages.
openclaw plugins search "calendar"

# Bare package specs try ClawHub first, then npm fallback.
openclaw plugins install <package>

# Force one source.
openclaw plugins install clawhub:<package>
openclaw plugins install npm:<package>

# Install a specific version or dist-tag.
openclaw plugins install clawhub:<package>@1.2.3
openclaw plugins install clawhub:<package>@beta
openclaw plugins install npm:@scope/[email protected]
openclaw plugins install npm:@openclaw/codex

# Install from git or a local development checkout.
openclaw plugins install git:github.com/acme/[email protected]
openclaw plugins install ./my-plugin
openclaw plugins install --link ./my-plugin

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

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

Usa inspect --runtime quando ti serve la prova che il plugin abbia registrato superfici runtime come strumenti, hook, servizi, metodi Gateway o comandi CLI di proprietà del plugin.

# Aggiornare i plugin

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

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

openclaw plugins update @scope/openclaw-plugin@beta
openclaw 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 su un tag.

Quando openclaw update viene eseguito sul canale beta, i record dei plugin npm e ClawHub sulla linea predefinita provano prima la release @beta del plugin corrispondente. Se quella release beta non esiste, OpenClaw ripiega sulla specifica predefinita/latest registrata. Per i plugin npm, OpenClaw ripiega anche quando il pacchetto beta esiste ma non supera la validazione di installazione. Le versioni esatte e i tag espliciti come @rc o @beta vengono preservati.

# Disinstallare i plugin

openclaw plugins uninstall <plugin-id> --dry-run
openclaw plugins uninstall <plugin-id>
openclaw plugins uninstall <plugin-id> --keep-files
openclaw gateway restart

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

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; per nix-openclaw, usa la Guida rapida orientata all’agente.

# Pubblicare i plugin

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

# Pubblicare su ClawHub

ClawHub è la principale superficie di scoperta pubblica per i plugin OpenClaw. Offre agli utenti metadati ricercabili, cronologia delle versioni e risultati di scansione del registro prima dell’installazione.

npm i -g clawhub
clawhub login
clawhub package publish your-org/your-plugin --dry-run
clawhub package publish your-org/your-plugin
clawhub package publish your-org/[email protected]

Gli utenti installano da ClawHub con:

openclaw plugins install clawhub:<package>
openclaw plugins install <package>

La forma semplice continua a controllare prima ClawHub.

# Pubblicare su npmjs.com

I plugin npm nativi devono includere un manifest del plugin e metadati del punto di ingresso OpenClaw in package.json.

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

npm publish --access public

Gli utenti installano solo da npm con:

openclaw plugins install npm:@acme/openclaw-plugin
openclaw plugins install npm:@acme/openclaw-plugin@beta
openclaw plugins install npm:@acme/[email protected]

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

# Scelta della sorgente

• ClawHub: usa quando vuoi scoperta nativa OpenClaw, riepiloghi di scansione, versioni e suggerimenti di installazione.
• npmjs.com: usa quando distribuisci già pacchetti JavaScript o hai bisogno di flussi di lavoro con dist-tag npm/registro privato.
• Git: usa quando vuoi installare direttamente da un branch, tag o commit.
• Percorso locale: usa quando stai sviluppando o testando un plugin sulla stessa macchina.

# Correlati

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