Passer au contenu principal

​
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

openclaw hooks list
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 : 
Hooks (4/4 ready)

Ready:
  🚀 boot-md ✓ - Run BOOT.md on gateway startup
  📝 command-logger ✓ - Log all command events to a centralized audit file
  💾 session-memory ✓ - Save session context to memory when /new command is issued
  😈 soul-evil ✓ - Swap injected SOUL content during a purge window or by random chance
Exemple (verbeux) : 
openclaw hooks list --verbose
Affiche les exigences manquantes pour les hooks non eligibles. Exemple (JSON) : 
openclaw hooks list --json
Retourne un JSON structure pour un usage programmatique.

​
Obtenir des informations sur un hook

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

Save session context to memory when /new command is issued

Details:
  Source: openclaw-bundled
  Path: /path/to/openclaw/hooks/bundled/session-memory/HOOK.md
  Handler: /path/to/openclaw/hooks/bundled/session-memory/handler.ts
  Homepage: https://docs.openclaw.ai/hooks#session-memory
  Events: command:new

Requirements:
  Config: ✓ workspace.dir

​
Verifier l’eligibilite des hooks

openclaw hooks check
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 : 
Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

​
Activer un hook

openclaw hooks enable <name>
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 : 
openclaw hooks enable session-memory
Sortie : 
✓ Enabled hook: 💾 session-memory
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

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

​
Installer des hooks

openclaw hooks install <path-or-spec>
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 : 
# Local directory
openclaw hooks install ./my-hook-pack

# Local archive
openclaw hooks install ./my-hook-pack.zip

# NPM package
openclaw hooks install @openclaw/my-hook-pack

# Link a local directory without copying
openclaw hooks install -l ./my-hook-pack

​
Mettre a jour des hooks

openclaw hooks update <id>
openclaw hooks update --all
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 : 
openclaw hooks enable session-memory
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 : 
les hooks openclaw activent bootstrap-extra-files
Voir : documentation bootstrap-extra-files

​
command-logger

Journalise tous les evenements de commande dans un fichier d’audit centralise. Activer : 
openclaw hooks enable command-logger
Sortie : ~/.openclaw/logs/commands.log Voir les logs : 
# Recent commands
tail -n 20 ~/.openclaw/logs/commands.log

# Pretty-print
cat ~/.openclaw/logs/commands.log | jq .

# Filter by action
grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .
Voir : documentation command-logger

​
boot-md

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