Skip to main content

​
openclaw hooks

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

​
Alle Hooks auflisten

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:
Beispiel (ausführlich):
Zeigt fehlende Voraussetzungen für ungeeignete Hooks an. Beispiel (JSON):
Gibt strukturiertes JSON zur programmgesteuerten Verwendung zurück.

​
Hook-Informationen abrufen

Zeigt detaillierte Informationen zu einem bestimmten Hook an. Argumente:
  • <name>: Hook-Name (z. B. session-memory)
Optionen:
  • --json: Ausgabe als JSON
Beispiel:
Ausgabe:

​
Hook-Eignung prüfen

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

​
Einen Hook aktivieren

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:
Ausgabe:
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

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

​
Hooks installieren

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:

​
Hooks aktualisieren

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:
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:
Siehe: bootstrap-extra-files Dokumentation

​
command-logger

Protokolliert alle Befehlsereignisse in eine zentrale Audit-Datei. Aktivieren:
Ausgabe: ~/.openclaw/logs/commands.log Protokolle anzeigen:
Siehe: command-logger-Dokumentation

​
boot-md

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