Skip to main content

​
openclaw hooks

Gerer les hooks d’agent (automatisations basees sur des evenements pour des commandes comme /new, /reset, et le demarrage de la Gateway (passerelle)). Associes :

​
Lister tous les hooks

Lister tous les hooks decouverts depuis les repertoires workspace, managed et bundled. Options :
  • --eligible : Afficher uniquement les hooks eligibles (exigences satisfaites)
  • --json : Sortie au format JSON
  • -v, --verbose : Afficher des informations detaillees, y compris les exigences manquantes
Exemple de sortie :
Exemple (verbeux) :
Affiche les exigences manquantes pour les hooks non eligibles. Exemple (JSON) :
Retourne un JSON structure pour un usage programmatique.

​
Obtenir des informations sur un hook

Afficher des informations detaillees sur un hook specifique. Arguments :
  • <name> : Nom du hook (par ex., session-memory)
Options :
  • --json : Sortie au format JSON
Exemple :
Sortie :

​
Verifier l’eligibilite des hooks

Afficher un resume de l’etat d’eligibilite des hooks (combien sont prets vs. non prets). Options :
  • --json : Sortie au format JSON
Exemple de sortie :

​
Activer un hook

Activer un hook specifique en l’ajoutant a votre configuration (~/.openclaw/config.json). Remarque : Les hooks geres par des plugins affichent plugin:<id> dans openclaw hooks list et ne peuvent pas etre actives/desactives ici. Activez/desactivez plutot le plugin. Arguments :
  • <name> : Nom du hook (par ex., session-memory)
Exemple :
Sortie :
Ce que cela fait :
  • Verifie que le hook existe et est eligible
  • Met a jour hooks.internal.entries.<name>.enabled = true dans votre configuration
  • Enregistre la configuration sur le disque
Apres l’activation :
  • Redemarrez la Gateway (passerelle) afin que les hooks soient recharges (redemarrage de l’application de la barre de menus sur macOS, ou redemarrage de votre processus de Gateway (passerelle) en dev).

​
Desactiver un hook

Desactiver un hook specifique en mettant a jour votre configuration. Arguments :
  • <name> : Nom du hook (par ex., command-logger)
Exemple :
Sortie :
Apres la desactivation :
  • Redemarrez la Gateway (passerelle) afin que les hooks soient recharges

​
Installer des hooks

Installer un pack de hooks depuis un dossier/une archive locale ou npm. Les spécifications Npm sont uniquement issues du registre (nom du package + version/tag optionnel). Les spécifications Git/URL/file sont rejetées. Les installations de dépendances s’exécutent avec --ignore-scripts pour des raisons de sécurité. Ce que cela fait :
  • Copie le pack de hooks dans ~/.openclaw/hooks/<id>
  • Active les hooks installes dans hooks.internal.entries.*
  • Enregistre l’installation sous hooks.internal.installs
Options :
  • -l, --link : Lier un repertoire local au lieu de copier (l’ajoute a hooks.internal.load.extraDirs)
Archives prises en charge : .zip, .tgz, .tar.gz, .tar Exemples :

​
Mettre a jour des hooks

Mettre a jour les packs de hooks installes (installations npm uniquement). Options :
  • --all : Mettre a jour tous les packs de hooks suivis
  • --dry-run : Afficher ce qui changerait sans ecrire

​
Hooks fournis

​
session-memory

Enregistre le contexte de session en memoire lorsque vous executez /new. Activer :
Sortie : ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md Voir : documentation session-memory

​
bootstrap-extra-files

Injecte des fichiers bootstrap supplémentaires (par exemple des fichiers AGENTS.md / TOOLS.md locaux à un monorepo) lors de agent:bootstrap. Activer :
Voir : documentation bootstrap-extra-files

​
command-logger

Journalise tous les evenements de commande dans un fichier d’audit centralise. Activer :
Sortie : ~/.openclaw/logs/commands.log Voir les logs :
Voir : documentation command-logger

​
boot-md

Execute BOOT.md lorsque la Gateway (passerelle) demarre (apres le demarrage des canaux). Activer : Evenements : gateway:startup
Voir : documentation boot-md