openclaw hooks

Agent-Hooks verwalten (ereignisgesteuerte Automatisierungen für Befehle wie /new, /reset und den Gateway-Start). openclaw hooks ohne weitere Argumente 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 gebündelten Verzeichnissen gefunden wurden.

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

Hooks (4/5 bereit) Bereit:  🚀 boot-md ✓ - BOOT.md beim Gateway-Start ausführen  📎 bootstrap-extra-files ✓ - Beim Agent-Bootstrap zusätzliche Workspace-Bootstrap-Dateien 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, Umgebungsvariablen, Konfiguration, Betriebssystem).

Verfügbarkeit 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 Grund für die Blockierung aufgelistet.

Einen Hook aktivieren

openclaw hooks enable <name>

Fügt hooks.internal.entries.<name>.enabled = true zur Konfiguration hinzu oder aktualisiert den Wert und aktiviert außerdem den Hauptschalter hooks.internal.enabled (der Gateway lädt keine internen Hook-Handler, solange nicht mindestens einer konfiguriert ist). Der Vorgang schlägt fehl, wenn der Hook nicht vorhanden ist, von einem Plugin verwaltet wird oder aufgrund fehlender Anforderungen nicht verfügbar ist.

Von Plugins verwaltete Hooks zeigen in hooks list den Eintrag plugin:<id> und können hier nicht aktiviert oder deaktiviert werden. Aktivieren oder deaktivieren Sie stattdessen das zuständige Plugin.

Starten Sie den 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 den 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 und openclaw hooks update funktionieren weiterhin als veraltete Aliase, die eine Warnung ausgeben und an die plugins-Befehle weiterleiten.

• Npm-Spezifikationen dürfen nur auf die Registry verweisen: Paketname sowie optional eine exakte Version oder ein Dist-Tag. Git-, URL- und Dateispezifikationen sowie SemVer-Bereiche werden abgelehnt. Abhängigkeiten werden projektlokal mit --ignore-scripts installiert.
• Spezifikationen ohne Zusatz und @latest bleiben auf dem stabilen Veröffentlichungskanal. Wenn npm eine Vorabversion auflöst, bricht OpenClaw ab 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, anstatt es zu kopieren (es wird hooks.internal.load.extraDirs hinzugefügt). Verknüpfte Hook-Pakete sind verwaltete Hooks aus einem vom Betreiber konfigurierten Verzeichnis und keine Workspace-Hooks.
• --pin speichert npm-Installationen mit der exakt aufgelösten Angabe name@version in hooks.internal.installs.
• Die Installation kopiert das Paket nach ~/.openclaw/hooks/<id>, aktiviert seine Hooks unter hooks.internal.entries.* und zeichnet die Installation unter hooks.internal.installs 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. Mit der globalen Option --yes können Sie die Abfrage umgehen, beispielsweise in CI.

Gebündelte Hooks

Aktivieren Sie einen beliebigen gebündelten Hook mit openclaw hooks enable <hook-name>. Vollständige Informationen, Konfigurationsschlüssel und Standardwerte: Gebündelte Hooks.

Protokolldatei von command-logger

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

Hinweise

• hooks list --json, info --json und check --json schreiben strukturiertes JSON direkt nach stdout.

Verwandte Themen

• CLI-Referenz
• Automatisierungs-Hooks