Skip to main content

openclaw hooks

Beheer agent hooks (eventgestuurde automatiseringen voor opdrachten zoals /new, /reset en het opstarten van de Gateway). Gerelateerd:

Alle hooks weergeven

Toon alle ontdekte hooks uit werkruimte-, beheerde en gebundelde mappen. Opties:
  • --eligible: Toon alleen geschikte hooks (vereisten voldaan)
  • --json: Uitvoer als JSON
  • -v, --verbose: Toon gedetailleerde informatie inclusief ontbrekende vereisten
Voorbeelduitvoer:
Voorbeeld (uitgebreid):
Toont ontbrekende vereisten voor niet-geschikte hooks. Voorbeeld (JSON):
Geeft gestructureerde JSON terug voor programmatisch gebruik.

Hookinformatie ophalen

Toon gedetailleerde informatie over een specifieke hook. Argumenten:
  • <name>: Hooknaam (bijv. session-memory)
Opties:
  • --json: Uitvoer als JSON
Voorbeeld:
Uitvoer:

Geschiktheid van hooks controleren

Toon een samenvatting van de geschiktheidsstatus van hooks (hoeveel gereed zijn vs. niet gereed). Opties:
  • --json: Uitvoer als JSON
Voorbeelduitvoer:

Een hook inschakelen

Schakel een specifieke hook in door deze aan je config toe te voegen (~/.openclaw/config.json). Let op: Hooks die door plugins worden beheerd tonen plugin:<id> in openclaw hooks list en kunnen hier niet worden in- of uitgeschakeld. Schakel in plaats daarvan de plugin in of uit. Argumenten:
  • <name>: Hooknaam (bijv. session-memory)
Voorbeeld:
Uitvoer:
Wat het doet:
  • Controleert of de hook bestaat en geschikt is
  • Werkt hooks.internal.entries.<name>.enabled = true bij in je config
  • Slaat de config op schijf op
Na inschakelen:
  • Start de Gateway opnieuw zodat hooks opnieuw worden geladen (herstart de menubalk-app op macOS, of herstart je Gateway-proces in dev).

Een hook uitschakelen

Schakel een specifieke hook uit door je config bij te werken. Argumenten:
  • <name>: Hooknaam (bijv. command-logger)
Voorbeeld:
Uitvoer:
Na uitschakelen:
  • Start de Gateway opnieuw zodat hooks opnieuw worden geladen

Hooks installeren

Installeer een hookpack vanuit een lokale map/archief of npm. Npm-specs zijn alleen registry (pakketnaam + optionele versie/tag). Git/URL/file specs worden afgewezen. Installaties van afhankelijkheden worden uitgevoerd met --ignore-scripts voor veiligheid. Wat het doet:
  • Kopieert het hookpack naar ~/.openclaw/hooks/<id>
  • Schakelt de geïnstalleerde hooks in hooks.internal.entries.* in
  • Registreert de installatie onder hooks.internal.installs
Opties:
  • -l, --link: Koppel een lokale map in plaats van kopiëren (voegt deze toe aan hooks.internal.load.extraDirs)
Ondersteunde archieven: .zip, .tgz, .tar.gz, .tar Voorbeelden:

Hooks bijwerken

Werk geïnstalleerde hookpacks bij (alleen npm-installaties). Opties:
  • --all: Werk alle gevolgde hookpacks bij
  • --dry-run: Toon wat er zou veranderen zonder te schrijven

Gebundelde hooks

session-memory

Slaat sessiecontext op in het geheugen wanneer je /new uitvoert. Inschakelen:
Uitvoer: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md Zie: session-memory documentatie

bootstrap-extra-files

Injecteert aanvullende bootstrap-bestanden (bijvoorbeeld monorepo-lokale AGENTS.md / TOOLS.md) tijdens agent:bootstrap. Inschakelen:
Zie: SOUL Evil Hook

command-logger

Logt alle opdrachtgebeurtenissen naar een gecentraliseerd auditbestand. Inschakelen:
Uitvoer: ~/.openclaw/logs/commands.log Logboeken bekijken:
Zie: command-logger documentatie

boot-md

Voert BOOT.md uit wanneer de Gateway start (nadat kanalen zijn gestart). Events: gateway:startup Inschakelen:
Zie: boot-md documentatie