Skip to main content

​
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

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.

​
Hook-Informationen abrufen

<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

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

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

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

​
Hook-Pakete installieren und aktualisieren

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

​
Hinweise

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

​
Verwandte Themen