Zum Hauptinhalt springen

​
openclaw hooks

Verwalten Sie Agent-Hooks (ereignisgesteuerte Automatisierungen für Befehle wie /new, /reset und den Gateway-Start). Verwandt:

​
Alle Hooks auflisten

openclaw hooks list
Listet alle erkannten Hooks aus Workspace-, verwalteten und gebündelten Verzeichnissen auf. Optionen:
  • --eligible: Nur geeignete Hooks anzeigen (Voraussetzungen erfüllt)
  • --json: Ausgabe als JSON
  • -v, --verbose: Detaillierte Informationen einschließlich fehlender Voraussetzungen anzeigen
Beispielausgabe: 
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
Beispiel (ausführlich): 
openclaw hooks list --verbose
Zeigt fehlende Voraussetzungen für ungeeignete Hooks an. Beispiel (JSON): 
openclaw hooks list --json
Gibt strukturiertes JSON zur programmgesteuerten Verwendung zurück.

​
Hook-Informationen abrufen

openclaw hooks info <name>
Zeigt detaillierte Informationen zu einem bestimmten Hook an. Argumente:
  • <name>: Hook-Name (z. B. session-memory)
Optionen:
  • --json: Ausgabe als JSON
Beispiel: 
openclaw hooks info session-memory
Ausgabe: 
💾 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

​
Hook-Eignung prüfen

openclaw hooks check
Zeigt eine Zusammenfassung des Eignungsstatus der Hooks (wie viele bereit sind vs. nicht bereit). Optionen:
  • --json: Ausgabe als JSON
Beispielausgabe: 
Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

​
Einen Hook aktivieren

openclaw hooks enable <name>
Aktiviert einen bestimmten Hook, indem er zu Ihrer Konfiguration (~/.openclaw/config.json) hinzugefügt wird. Hinweis: Von Plugins verwaltete Hooks zeigen plugin:<id> in openclaw hooks list an und können hier nicht aktiviert/deaktiviert werden. Aktivieren/deaktivieren Sie stattdessen das Plugin. Argumente:
  • <name>: Hook-Name (z. B. session-memory)
Beispiel: 
openclaw hooks enable session-memory
Ausgabe: 
✓ Enabled hook: 💾 session-memory
Was es tut:
  • Prüft, ob der Hook existiert und geeignet ist
  • Aktualisiert hooks.internal.entries.<name>.enabled = true in Ihrer Konfiguration
  • Speichert die Konfiguration auf der Festplatte
Nach dem Aktivieren:
  • Starten Sie das Gateway neu, damit Hooks neu geladen werden (Neustart der Menüleisten-App unter macOS oder Neustart Ihres Gateway-Prozesses in der Entwicklung).

​
Einen Hook deaktivieren

openclaw hooks disable <name>
Deaktiviert einen bestimmten Hook durch Aktualisieren Ihrer Konfiguration. Argumente:
  • <name>: Hook-Name (z. B. command-logger)
Beispiel: 
openclaw hooks disable command-logger
Ausgabe: 
⏸ Disabled hook: 📝 command-logger
Nach dem Deaktivieren:
  • Starten Sie das Gateway neu, damit Hooks neu geladen werden

​
Hooks installieren

openclaw hooks install <path-or-spec>
Installiert ein Hook-Paket aus einem lokalen Ordner/Archiv oder von npm. Npm-Spezifikationen sind nur Registry-basiert (Paketname + optionale Version/Tag). Git/URL/File- Spezifikationen werden abgelehnt. Abhängigkeitsinstallationen werden aus Sicherheitsgründen mit --ignore-scripts ausgeführt. Was es tut:
  • Kopiert das Hook-Paket nach ~/.openclaw/hooks/<id>
  • Aktiviert die installierten Hooks in hooks.internal.entries.*
  • Erfasst die Installation unter hooks.internal.installs
Optionen:
  • -l, --link: Lokales Verzeichnis verknüpfen statt kopieren (fügt es zu hooks.internal.load.extraDirs hinzu)
Unterstützte Archive: .zip, .tgz, .tar.gz, .tar Beispiele: 
# 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

​
Hooks aktualisieren

openclaw hooks update <id>
openclaw hooks update --all
Aktualisiert installierte Hook-Pakete (nur npm-Installationen). Optionen:
  • --all: Alle verfolgten Hook-Pakete aktualisieren
  • --dry-run: Anzeigen, was sich ändern würde, ohne zu schreiben

​
Gebündelte Hooks

​
session-memory

Speichert Sitzungskontext im Speicher, wenn Sie /new ausführen. Aktivieren: 
openclaw hooks enable session-memory
Ausgabe: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md Siehe: session-memory-Dokumentation

​
bootstrap-extra-files

Fügt zusätzliche Bootstrap-Dateien (zum Beispiel monorepo-lokale AGENTS.md / TOOLS.md) während agent:bootstrap ein. Aktivieren: 
openclaw Hooks aktivieren bootstrap-extra-files
Siehe: bootstrap-extra-files Dokumentation

​
command-logger

Protokolliert alle Befehlsereignisse in eine zentrale Audit-Datei. Aktivieren: 
openclaw hooks enable command-logger
Ausgabe: ~/.openclaw/logs/commands.log Protokolle anzeigen: 
# 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 .
Siehe: command-logger-Dokumentation

​
boot-md

Führt BOOT.md aus, wenn das Gateway startet (nachdem Kanäle gestartet sind). Ereignisse: gateway:startup Aktivieren: 
openclaw hooks enable boot-md
Siehe: boot-md-Dokumentation