openclaw hooks¶

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

Verwandt:

• Hooks: Hooks
• Plugin-Hooks: Plugins

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 specs are registry-only (package name + optional version/tag). Git/URL/file specs are rejected. Dependency installs run with --ignore-scripts for safety.

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¶

Injects additional bootstrap files (for example monorepo-local AGENTS.md / TOOLS.md) during agent:bootstrap.

Aktivieren:

openclaw hooks enable bootstrap-extra-files

See: bootstrap-extra-files documentation

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