OpenClaw Hooks verwalten: Automatisierung steuern

Oftmals verbringen wir als Entwickler zu viel Zeit damit, repetitive Aufgaben manuell zu verwalten oder darauf zu warten, dass Automatisierungen endlich greifen. Mit OpenClaw Hooks kannst du genau diese ereignisgesteuerten Abläufe effizient automatisieren und deine Workflows direkt in das Gateway integrieren.

In diesem Leitfaden erfährst du, wie du OpenClaw Hooks verwaltest, um deine Automatisierungen für Befehle wie /new, /reset oder den Gateway-Start zu optimieren.

Alle Hooks auflisten

Wenn du dir einen Überblick über alle verfügbaren Hooks verschaffen möchtest, kannst du den folgenden Befehl verwenden. Beachte, dass das Gateway interne Hook-Handler erst lädt, sobald mindestens ein interner Hook konfiguriert wurde.

openclaw hooks list

Optionen:

• --eligible: Zeigt nur die Hooks an, deren Anforderungen erfüllt sind.
• --json: Gibt das Ergebnis als JSON aus.
• -v, --verbose: Zeigt detaillierte Informationen, einschließlich fehlender Anforderungen.

Beispielausgabe:

Hooks (4/4 ready)

Ready:
  🚀 boot-md ✓ - Run BOOT.md on gateway startup
  📎 bootstrap-extra-files ✓ - Inject extra workspace bootstrap files during agent bootstrap
  📝 command-logger ✓ - Log all command events to a centralized audit file
  💾 session-memory ✓ - Save session context to memory when /new or /reset command is issued

Beispiel (verbose):

openclaw hooks list --verbose

Beispiel (JSON):

openclaw hooks list --json

Hook-Informationen abrufen

Wenn du spezifische Details zu einem bestimmten Hook benötigst, kannst du diesen Befehl nutzen.

openclaw hooks info <name>

Argumente:

• <name>: Name oder Key des Hooks (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 or /reset 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, command:reset

Requirements:
  Config: ✓ workspace.dir

Eignung der Hooks prüfen

Mit diesem Befehl erhältst du eine schnelle Zusammenfassung, wie viele deiner Hooks einsatzbereit sind und wie viele noch konfiguriert werden müssen.

openclaw hooks check

Optionen:

• --json: Ausgabe als JSON.

Beispielausgabe:

Hooks Status

Total hooks: 4
Ready: 4
Not ready: 0

Einen Hook aktivieren

Du kannst einen Hook aktivieren, indem du ihn zu deiner Konfiguration (standardmäßig ~/.openclaw/openclaw.json) hinzufügst.

openclaw hooks enable <name>

Hinweis: Workspace-Hooks sind standardmäßig deaktiviert. Hooks, die über Plugins verwaltet werden, zeigen plugin:<id> in der Liste an und können hier nicht direkt aktiviert werden; aktiviere stattdessen das entsprechende Plugin.

Argumente:

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

Beispiel:

openclaw hooks enable session-memory

Ausgabe:

✓ Enabled hook: 💾 session-memory

Was passiert dabei:

• Es wird geprüft, ob der Hook existiert und die Voraussetzungen erfüllt sind.
• Der Eintrag hooks.internal.entries.<name>.enabled = true wird in deiner Konfiguration aktualisiert.
• Die Konfiguration wird auf der Festplatte gespeichert.

Nach der Aktivierung:

• Starte das Gateway neu, damit die Hooks neu geladen werden (Neustart der Menüleisten-App unter macOS oder Neustart deines Gateway-Prozesses in der Entwicklung).

Einen Hook deaktivieren

Wenn du einen Hook nicht mehr benötigst, kannst du ihn einfach über deine Konfiguration deaktivieren.

openclaw hooks disable <name>

Argumente:

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

Beispiel:

openclaw hooks disable command-logger

Ausgabe:

⏸ Disabled hook: 📝 command-logger

Nach der Deaktivierung:

• Starte das Gateway neu, damit die Hooks neu geladen werden.

Hinweise

• openclaw hooks list --json, info --json und check --json schreiben strukturiertes JSON direkt in die Standardausgabe (stdout).
• Plugin-verwaltete Hooks können hier nicht aktiviert oder deaktiviert werden; nutze dafür die Plugin-Verwaltung.

Hook-Packs installieren

Du kannst Hook-Packs über den einheitlichen Plugin-Installer hinzufügen.

openclaw plugins install <package>        # ClawHub first, then npm
openclaw plugins install <package> --pin  # pin version
openclaw plugins install <path>           # local path

openclaw hooks install funktioniert weiterhin als Kompatibilitäts-Alias, gibt jedoch eine Warnung aus und leitet an openclaw plugins install weiter. npm-Spezifikationen sind auf die Registry beschränkt.

Was passiert dabei:

• Das Hook-Pack wird nach ~/.openclaw/hooks/<id> kopiert.
• Die installierten Hooks werden unter hooks.internal.entries.* aktiviert.
• Die Installation wird unter hooks.internal.installs protokolliert.

Optionen:

• -l, --link: Verlinkt ein lokales Verzeichnis, anstatt es zu kopieren.
• --pin: Speichert npm-Installationen mit exakter Version.

Beispiele:

# Local directory
openclaw plugins install ./my-hook-pack

# Local archive
openclaw plugins install ./my-hook-pack.zip

# NPM package
openclaw plugins install @openclaw/my-hook-pack

# Link a local directory without copying
openclaw plugins install -l ./my-hook-pack

Hook-Packs aktualisieren

Aktualisiere deine npm-basierten Hook-Packs bequem über den Plugin-Updater.

openclaw plugins update <id>
openclaw plugins update --all

openclaw hooks update funktioniert weiterhin als Alias, gibt aber eine Warnung aus.

Optionen:

• --all: Aktualisiert alle verfolgten Hook-Packs.
• --dry-run: Zeigt Änderungen an, ohne sie anzuwenden.

Gebündelte Hooks

session-memory

Dieser Hook speichert den Sitzungskontext im Arbeitsspeicher, sobald du /new oder /reset ausführst.

Aktivieren:

openclaw hooks enable session-memory

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

bootstrap-extra-files

Dieser Hook injiziert zusätzliche Bootstrap-Dateien (wie z. B. AGENTS.md oder TOOLS.md in einem Monorepo) während des agent:bootstrap.

Aktivieren:

openclaw hooks enable bootstrap-extra-files

command-logger

Protokolliert alle Befehlsereignisse in einer zentralen Audit-Datei.

Aktivieren:

openclaw hooks enable command-logger

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

Logs 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 .

boot-md

Führt BOOT.md aus, sobald das Gateway startet (nachdem die Kanäle gestartet wurden).

Events: gateway:startup

Aktivieren:

openclaw hooks enable boot-md

---

Nächste Schritte

Brauchst du weitere Unterstützung bei der Einrichtung? Hier findest du Hilfe: AI Setup Assistant

Verwandte Dokumentation:

• Hooks
• Plugin hooks