Skip to main content

​
openclaw hooks

Gestisce gli hook degli agenti (automazioni basate su eventi per comandi come /new, /reset e l’avvio del Gateway). Il semplice comando openclaw hooks equivale a openclaw hooks list. Correlati: Hook - Hook dei Plugin

​
Elencare gli hook

Elenca gli hook rilevati nelle directory dell’area di lavoro, gestite, aggiuntive e integrate.
  • --eligible: solo gli hook i cui requisiti sono soddisfatti.
  • --json: output strutturato.
  • -v, --verbose: include una colonna Mancanti con i requisiti non soddisfatti.

​
Ottenere informazioni su un hook

<name> è il nome o la chiave dell’hook (ad esempio session-memory). Mostra l’origine, i percorsi dei file e dei gestori, la pagina iniziale, gli eventi e lo stato di ciascun requisito (file binari, ambiente, configurazione, sistema operativo).

​
Verificare l’idoneità

Stampa un riepilogo del numero di hook pronti e non pronti; se alcuni hook non sono pronti, li elenca indicando per ciascuno il motivo del blocco.

​
Abilitare un hook

Aggiunge o aggiorna hooks.internal.entries.<name>.enabled = true nella configurazione e attiva anche l’interruttore principale hooks.internal.enabled (il Gateway non carica alcun gestore di hook interno finché non ne viene configurato almeno uno). Il comando non riesce se l’hook non esiste, è gestito da un Plugin o non è idoneo (requisiti mancanti). Gli hook gestiti dai Plugin mostrano plugin:<id> in hooks list e non possono essere abilitati o disabilitati da qui; abilita o disabilita invece il Plugin proprietario. Dopo l’abilitazione, riavvia il Gateway (riavvia l’app della barra dei menu di macOS oppure, in fase di sviluppo, il processo del Gateway) affinché ricarichi gli hook.

​
Disabilitare un hook

Imposta hooks.internal.entries.<name>.enabled = false. In seguito, riavvia il Gateway.

​
Installare e aggiornare i pacchetti di hook

I pacchetti di hook vengono installati tramite il programma unificato di installazione e aggiornamento dei Plugin; openclaw hooks install e openclaw hooks update continuano a funzionare come alias deprecati che mostrano un avviso e inoltrano l’operazione ai comandi plugins.
  • Le specifiche npm possono fare riferimento esclusivamente al registro: nome del pacchetto più un’eventuale versione esatta o dist-tag. Le specifiche Git, URL e file e gli intervalli semver vengono rifiutati. Le dipendenze vengono installate localmente nel progetto con --ignore-scripts.
  • Le specifiche senza qualificatore e @latest rimangono sul canale stabile; se npm risolve una versione preliminare, OpenClaw interrompe l’operazione e chiede di aderire esplicitamente (@beta, @rc o una versione preliminare esatta).
  • Archivi supportati: .zip, .tgz, .tar.gz, .tar.
  • -l, --link collega una directory locale invece di copiarla (aggiungendola a hooks.internal.load.extraDirs); i pacchetti di hook collegati sono hook gestiti provenienti da una directory configurata dall’operatore, non hook dell’area di lavoro.
  • --pin registra le installazioni npm come name@version risolto esatto in hooks.internal.installs.
  • L’installazione copia il pacchetto in ~/.openclaw/hooks/<id>, abilita i relativi hook in hooks.internal.entries.* e registra l’installazione in hooks.internal.installs.
  • Se un hash di integrità memorizzato non corrisponde più all’artefatto recuperato, OpenClaw mostra un avviso e chiede conferma prima di continuare; passa l’opzione globale --yes per ignorare la richiesta (ad esempio in CI).

​
Hook integrati

Abilita qualsiasi hook integrato con openclaw hooks enable <hook-name>. Dettagli completi, chiavi di configurazione e valori predefiniti: Hook integrati.

​
File di registro di command-logger

​
Note

  • hooks list --json, info --json e check --json scrivono il JSON strutturato direttamente nello standard output.

​
Contenuti correlati