openclaw hooks

Verwalte Agent-Hooks (ereignisgesteuerte Automatisierungen f\u00fcr Befehle wie /new, /reset und Gateway-Startup).

Verwandte Themen:

Alle Hooks auflisten

openclaw hooks list

Listet alle entdeckten Hooks aus Workspace-, Managed- und Bundled-Verzeichnissen auf.

Optionen:

  • --eligible: Nur berechtigte Hooks anzeigen (Anforderungen erf\u00fcllt)
  • --json: Ausgabe als JSON
  • -v, --verbose: Detaillierte Informationen einschlie\u00dflich fehlender Anforderungen anzeigen

Beispielausgabe:

Hooks (4/4 ready)

Ready:
  \ud83d\ude80 boot-md \u2713 - Run BOOT.md on gateway startup
  \ud83d\udcce bootstrap-extra-files \u2713 - Inject extra workspace bootstrap files during agent bootstrap
  \ud83d\udcdd command-logger \u2713 - Log all command events to a centralized audit file
  \ud83d\udcbe session-memory \u2713 - Save session context to memory when /new command is issued

Beispiel (ausf\u00fchrlich):

openclaw hooks list --verbose

Zeigt fehlende Anforderungen f\u00fcr nicht berechtigte Hooks.

Beispiel (JSON):

openclaw hooks list --json

Gibt strukturiertes JSON f\u00fcr programmatische Nutzung zur\u00fcck.

Hook-Informationen abrufen

openclaw hooks info <name>

Zeigt detaillierte Informationen \u00fcber einen bestimmten Hook.

Argumente:

  • <name>: Hook-Name (z.B. session-memory)

Optionen:

  • --json: Ausgabe als JSON

Beispiel:

openclaw hooks info session-memory

Ausgabe:

\ud83d\udcbe session-memory \u2713 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/automation/hooks#session-memory
  Events: command:new

Requirements:
  Config: \u2713 workspace.dir

Hook-Berechtigung pr\u00fcfen

openclaw hooks check

Zeigt eine Zusammenfassung des Hook-Berechtigungsstatus (wie viele bereit 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 deiner Config (~/.openclaw/config.json) hinzugef\u00fcgt wird.

Hinweis: Von Plugins verwaltete Hooks zeigen plugin:<id> in openclaw hooks list und k\u00f6nnen hier nicht aktiviert/deaktiviert werden. Aktiviere/deaktiviere stattdessen das Plugin.

Argumente:

  • <name>: Hook-Name (z.B. session-memory)

Beispiel:

openclaw hooks enable session-memory

Ausgabe:

\u2713 Enabled hook: \ud83d\udcbe session-memory

Was passiert:

  • Pr\u00fcft, ob der Hook existiert und berechtigt ist
  • Aktualisiert hooks.internal.entries.<name>.enabled = true in deiner Config
  • Speichert die Config auf Festplatte

Nach dem Aktivieren:

  • Starte das Gateway neu, damit Hooks neu geladen werden (Men\u00fcleisten-App-Neustart unter macOS oder Gateway-Prozess im Dev-Modus neustarten).

Einen Hook deaktivieren

openclaw hooks disable <name>

Deaktiviert einen bestimmten Hook durch Aktualisierung deiner Config.

Argumente:

  • <name>: Hook-Name (z.B. command-logger)

Beispiel:

openclaw hooks disable command-logger

Ausgabe:

\u23f8 Disabled hook: \ud83d\udcdd command-logger

Nach dem Deaktivieren:

  • Starte das Gateway neu, damit Hooks neu geladen werden

Hooks installieren

openclaw hooks install <path-or-spec>
openclaw hooks install <npm-spec> --pin

Installiert ein Hook-Pack aus einem lokalen Ordner/Archiv oder npm.

npm-Specs sind registry-only (Paketname + optionale exakte Version oder dist-tag). Git/URL/Datei-Specs und Semver-Bereiche werden abgelehnt. Dependency- Installationen laufen mit --ignore-scripts aus Sicherheitsgr\u00fcnden.

Bare-Specs und @latest bleiben auf dem stabilen Track. Wenn npm eines davon zu einem Prerelease aufl\u00f6st, stoppt OpenClaw und fordert dich auf, explizit mit einem Prerelease-Tag wie @beta/@rc oder einer exakten Prerelease-Version zuzustimmen.

Was passiert:

  • Kopiert das Hook-Pack nach ~/.openclaw/hooks/<id>
  • Aktiviert die installierten Hooks in hooks.internal.entries.*
  • Zeichnet die Installation unter hooks.internal.installs auf

Optionen:

  • -l, --link: Ein lokales Verzeichnis verlinken statt kopieren (f\u00fcgt es zu hooks.internal.load.extraDirs hinzu)
  • --pin: npm-Installationen als exakte aufgel\u00f6ste name@version in hooks.internal.installs aufzeichnen

Unterst\u00fctzte Archive: .zip, .tgz, .tar.gz, .tar

Beispiele:

# Lokales Verzeichnis
openclaw hooks install ./my-hook-pack

# Lokales Archiv
openclaw hooks install ./my-hook-pack.zip

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

# Ein lokales Verzeichnis verlinken ohne zu kopieren
openclaw hooks install -l ./my-hook-pack

Hooks aktualisieren

openclaw hooks update <id>
openclaw hooks update --all

Aktualisiert installierte Hook-Packs (nur npm-Installationen).

Optionen:

  • --all: Alle verfolgten Hook-Packs aktualisieren
  • --dry-run: Zeigen, was sich \u00e4ndern w\u00fcrde, ohne zu schreiben

Wenn ein gespeicherter Integrit\u00e4ts-Hash existiert und sich der Hash des heruntergeladenen Artefakts \u00e4ndert, gibt OpenClaw eine Warnung aus und fragt vor dem Fortfahren nach Best\u00e4tigung. Verwende das globale --yes, um Prompts in CI-/nicht-interaktiven L\u00e4ufen zu \u00fcberspringen.

Mitgelieferte Hooks

session-memory

Speichert Session-Kontext im Memory, wenn du /new ausl\u00f6st.

Aktivieren:

openclaw hooks enable session-memory

Ausgabe: ~/.openclaw/workspace/memory/YYYY-MM-DD-slug.md

Siehe: session-memory-Dokumentation

bootstrap-extra-files

Injiziert zus\u00e4tzliche Bootstrap-Dateien (z.B. monorepo-lokale AGENTS.md / TOOLS.md) w\u00e4hrend agent:bootstrap.

Aktivieren:

openclaw hooks enable bootstrap-extra-files

Siehe: bootstrap-extra-files-Dokumentation

command-logger

Loggt alle Command-Events in eine zentrale Audit-Datei.

Aktivieren:

openclaw hooks enable command-logger

Ausgabe: ~/.openclaw/logs/commands.log

Logs ansehen:

# Letzte Befehle
tail -n 20 ~/.openclaw/logs/commands.log

# H\u00fcbsch ausgeben
cat ~/.openclaw/logs/commands.log | jq .

# Nach Aktion filtern
grep '"action":"new"' ~/.openclaw/logs/commands.log | jq .

Siehe: command-logger-Dokumentation

boot-md

F\u00fchrt BOOT.md aus, wenn das Gateway startet (nach dem Channel-Start).

Events: gateway:startup

Aktivieren:

openclaw hooks enable boot-md

Siehe: boot-md-Dokumentation

arrow_back
Zurück
Health
Weiter
Logs
arrow_forward