openclaw hooks

Verwalten Sie Agent-Hooks (ereignisgesteuerte Automatisierungen für Befehle wie /new, /reset und den Start des Gateways). openclaw hooks allein entspricht openclaw hooks list.

Verwandte Themen: Hooks – Plugin-Hooks

Hooks auflisten

openclaw hooks list [--eligible] [--json] [-v|--verbose]

Listet Hooks auf, die in Workspace-, verwalteten, zusätzlichen und mitgelieferten Verzeichnissen gefunden wurden.

• --eligible: nur Hooks, deren Anforderungen erfüllt sind.
• --json: strukturierte Ausgabe.
• -v, --verbose: fügt eine Spalte „Fehlend“ mit nicht erfüllten Anforderungen hinzu.

Hooks (4/5 bereit) Bereit:  🚀 boot-md ✓ - BOOT.md beim Start des Gateways ausführen  📎 bootstrap-extra-files ✓ - Zusätzliche Workspace-Bootstrap-Dateien während des Agent-Bootstrappings einfügen  📝 command-logger ✓ - Alle Befehlsereignisse in einer zentralen Auditdatei protokollieren  💾 session-memory ✓ - Sitzungskontext im Speicher sichern, wenn der Befehl /new oder /reset ausgeführt wird

Hook-Informationen abrufen

openclaw hooks info <name> [--json]

<name> ist der Hook-Name oder Hook-Schlüssel (zum Beispiel session-memory). Zeigt Quelle, Datei-/Handler-Pfade, Homepage, Ereignisse und den Status der einzelnen Anforderungen (Binärdateien, Umgebung, Konfiguration, Betriebssystem).

Eignung prüfen

openclaw hooks check [--json]

Gibt eine Zusammenfassung der Anzahl bereiter bzw. nicht bereiter Hooks aus; wenn Hooks nicht bereit sind, werden sie jeweils mit dem blockierenden Grund aufgeführt.

Einen Hook aktivieren

openclaw hooks enable <name>

Fügt hooks.internal.entries.<name>.enabled = true in der Konfiguration hinzu bzw. aktualisiert es und aktiviert außerdem den Hauptschalter hooks.internal.enabled (das Gateway lädt keinen internen Hook-Handler, solange nicht mindestens einer konfiguriert ist). Der Vorgang schlägt fehl, wenn der Hook nicht existiert, von einem Plugin verwaltet wird oder nicht geeignet ist (fehlende Anforderungen).

Von Plugins verwaltete Hooks zeigen plugin:<id> in hooks list an und können hier nicht aktiviert oder deaktiviert werden; aktivieren oder deaktivieren Sie stattdessen das zugehörige Plugin.

Starten Sie das Gateway nach der Aktivierung neu (Neustart der macOS-Menüleisten-App oder im Entwicklungsbetrieb Neustart Ihres Gateway-Prozesses), damit die Hooks neu geladen werden.

Einen Hook deaktivieren

openclaw hooks disable <name>

Setzt hooks.internal.entries.<name>.enabled = false. Starten Sie das Gateway anschließend neu.

Hook-Pakete installieren und aktualisieren

openclaw plugins install <package>        # standardmäßig npmopenclaw plugins install npm:<package>    # nur npmopenclaw plugins install <package> --pin  # aufgelöste Version fixierenopenclaw plugins install <path>           # lokales Verzeichnis oder Archivopenclaw plugins install -l <path>        # lokales Verzeichnis verknüpfen statt kopieren openclaw plugins update <id>openclaw plugins update --allopenclaw plugins update --dry-run

Hook-Pakete werden über das einheitliche Installations- und Aktualisierungsprogramm für Plugins installiert; openclaw hooks install / openclaw hooks update funktionieren weiterhin als veraltete Aliasse, die eine Warnung ausgeben und an die plugins-Befehle weiterleiten.

• Npm-Spezifikationen sind ausschließlich für die Registry vorgesehen: Paketname plus optional eine exakte Version oder ein Dist-Tag. Git-/URL-/Dateispezifikationen und SemVer-Bereiche werden abgelehnt. Abhängigkeiten werden mit --ignore-scripts projektlokal installiert.
• Unqualifizierte Spezifikationen und @latest bleiben im stabilen Kanal; wenn npm eine Vorabversion auflöst, hält OpenClaw an und fordert Sie zur ausdrücklichen Zustimmung auf (@beta, @rc oder eine exakte Vorabversion).
• Unterstützte Archive: .zip, .tgz, .tar.gz, .tar.
• -l, --link verknüpft ein lokales Verzeichnis, statt es zu kopieren (es wird zu hooks.internal.load.extraDirs hinzugefügt); verknüpfte Hook-Pakete sind verwaltete Hooks aus einem vom Betreiber konfigurierten Verzeichnis und keine Workspace-Hooks.
• --pin zeichnet npm-Installationen mit einer exakt aufgelösten name@version im gemeinsam genutzten SQLite-Status auf.
• Die Installation kopiert das Paket nach ~/.openclaw/hooks/<id>, aktiviert dessen Hooks unter hooks.internal.entries.* und zeichnet die Installationsherkunft im gemeinsam genutzten SQLite-Status auf.
• Wenn ein gespeicherter Integritäts-Hash nicht mehr mit dem abgerufenen Artefakt übereinstimmt, warnt OpenClaw und fordert vor dem Fortfahren zur Bestätigung auf; übergeben Sie die globale Option --yes, um die Abfrage zu umgehen (zum Beispiel in CI).

Mitgelieferte Hooks

Aktivieren Sie einen beliebigen mitgelieferten Hook mit openclaw hooks enable <hook-name>. Vollständige Details, Konfigurationsschlüssel und Standardwerte: Mitgelieferte Hooks.

Protokolldatei von command-logger

tail -n 20 ~/.openclaw/logs/commands.log        # letzte Befehlecat ~/.openclaw/logs/commands.log | jq .          # übersichtlich ausgebengrep '"action":"new"' ~/.openclaw/logs/commands.log | jq .   # nach Aktion filtern

Hinweise

• hooks list --json, info --json und check --json schreiben strukturiertes JSON direkt in die Standardausgabe.

Verwandte Themen

• CLI-Referenz
• Automatisierungs-Hooks