Hoppa till huvudinnehåll

​
openclaw hooks

Hantera agent-hooks (händelsedrivna automatiseringar för kommandon som /new, /reset och gateway-start). Relaterat:

​
Lista alla hooks

openclaw hooks list
Lista alla upptäckta hooks från arbetsytans, hanterade och paketerade kataloger. Alternativ:
  • --eligible: Visa endast behöriga hooks (krav uppfyllda)
  • --json: Utdata som JSON
  • -v, --verbose: Visa detaljerad information inklusive saknade krav
Exempelutdata: 
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
Exempel (utförlig): 
openclaw hooks list --verbose
Visar saknade krav för obehöriga hooks. Exempel (JSON): 
openclaw hooks list --json
Returnerar strukturerad JSON för programmatisk användning.

​
Hämta hook-information

openclaw hooks info <name>
Visa detaljerad information om en specifik hook. Argument:
  • <name>: Kroknamn (t.ex., session-memory)
Alternativ:
  • --json: Utdata som JSON
Exempel: 
openclaw hooks info session-memory
Utdata: 
💾 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

​
Kontrollera hooks behörighet

openclaw hooks check
Visa en sammanfattning av hooks behörighetsstatus (hur många som är redo jämfört med inte redo). Alternativ:
  • --json: Utdata som JSON
Exempelutdata: 
Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

​
Aktivera en hook

openclaw hooks enable <name>
Aktivera en specifik hook genom att lägga till den i din konfig (~/.openclaw/config.json). Observera: Krokar som hanteras av plugins visar plugin:<id> i openclaw hooks list och kan inte aktiveras/inaktiveras här. Aktivera/inaktivera plugin istället. Argument:
  • <name>: Kroknamn (t.ex., session-memory)
Exempel: 
openclaw hooks enable session-memory
Utdata: 
✓ Enabled hook: 💾 session-memory
Vad den gör:
  • Kontrollerar om hooken finns och är behörig
  • Uppdaterar hooks.internal.entries.<name>.enabled = true i din konfiguration
  • Sparar konfig till disk
Efter aktivering:
  • Starta om gateway (nätverksgateway) så att hooks laddas om (starta om menyradsappen på macOS, eller starta om din gateway-process i utveckling).

​
Inaktivera en hook

openclaw hooks disable <name>
Inaktivera en specifik hook genom att uppdatera din konfig. Argument:
  • <name>: Kroknamn (t.ex., command-logger)
Exempel: 
openclaw hooks disable command-logger
Utdata: 
⏸ Disabled hook: 📝 command-logger
Efter inaktivering:
  • Starta om gateway (nätverksgateway) så att hooks laddas om

​
Installera hooks

openclaw hooks install <path-or-spec>
Installera ett hook-paket från en lokal mapp/arkiv eller npm. Npm-specifikationer är endast för registry (paketnamn + valfri version/tagg). Git/URL/file specifikationer avvisas. Beroendeinstallationer körs med --ignore-scripts av säkerhetsskäl. Vad den gör:
  • Kopierar hook-paketet till ~/.openclaw/hooks/<id>
  • Aktiverar de installerade hooks i hooks.internal.entries.*
  • Registrerar installationen under hooks.internal.installs
Alternativ:
  • -l, --link: Länka en lokal katalog i stället för att kopiera (lägger till den i hooks.internal.load.extraDirs)
Exempel: Exempel: 
# 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

​
Uppdatera hooks

openclaw hooks update <id>
openclaw hooks update --all
Alternativ: Alternativ:
  • --all: Uppdatera alla spårade hook-paket
  • --dry-run: Visa vad som skulle ändras utan att skriva

​
Medföljande hooks

​
session-memory

Aktivera: Aktivera: 
openclaw hooks enable session-memory
Se: session-memory-dokumentation Se: session-memory-dokumentation

​
bootstrap-extra-files

Aktivera: Aktivera: 
openclaw hooks aktiverar bootstrap-extra-files
Visa loggar:

​
command-logger

Se: command-logger-dokumentation Aktivera: 
openclaw hooks enable command-logger
Aktivera: Visa loggar: 
# 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 .
Se: command-logger-dokumentation

​
boot-md

Händelser: gateway:startup Aktivera: Aktivera: 
openclaw hooks enable boot-md
Se: boot-md-dokumentation