Skip to main content

​
openclaw hooks

Zarządzaj hookami agenta (automatyzacjami sterowanymi zdarzeniami dla poleceń takich jak /new i /reset oraz uruchamiania Gateway). Samo openclaw hooks jest równoważne poleceniu openclaw hooks list. Powiązane: Hooki — Hooki Pluginów

​
Wyświetlanie hooków

Wyświetla hooki wykryte w katalogach obszaru roboczego, zarządzanych, dodatkowych i dołączonych.
  • --eligible: tylko hooki, których wymagania są spełnione.
  • --json: ustrukturyzowane dane wyjściowe.
  • -v, --verbose: dołącza kolumnę braków z niespełnionymi wymaganiami.

​
Pobieranie informacji o hooku

<name> to nazwa lub klucz hooka (na przykład session-memory). Wyświetla źródło, ścieżki pliku i procedury obsługi, stronę główną, zdarzenia oraz stan poszczególnych wymagań (pliki wykonywalne, środowisko, konfiguracja, system operacyjny).

​
Sprawdzanie dostępności

Wyświetla podsumowanie liczby gotowych i niegotowych hooków; jeśli niektóre hooki nie są gotowe, wyświetla każdy z nich wraz z przyczyną blokady.

​
Włączanie hooka

Dodaje lub aktualizuje w konfiguracji ustawienie hooks.internal.entries.<name>.enabled = true, a także włącza główny przełącznik hooks.internal.enabled (Gateway nie wczytuje żadnej wewnętrznej procedury obsługi hooka, dopóki nie zostanie skonfigurowany co najmniej jeden hook). Polecenie kończy się niepowodzeniem, jeśli hook nie istnieje, jest zarządzany przez Plugin lub nie jest dostępny (brakujące wymagania). Hooki zarządzane przez Plugin mają oznaczenie plugin:<id> w wyniku hooks list i nie można ich tutaj włączać ani wyłączać; zamiast tego włącz lub wyłącz Plugin będący ich właścicielem. Po włączeniu uruchom ponownie Gateway (uruchom ponownie aplikację paska menu systemu macOS lub proces Gateway w środowisku programistycznym), aby ponownie wczytał hooki.

​
Wyłączanie hooka

Ustawia hooks.internal.entries.<name>.enabled = false. Następnie uruchom ponownie Gateway.

​
Instalowanie i aktualizowanie pakietów hooków

Pakiety hooków są instalowane za pomocą ujednoliconego instalatora i aktualizatora Pluginów; openclaw hooks install i openclaw hooks update nadal działają jako przestarzałe aliasy, które wyświetlają ostrzeżenie i przekazują wywołanie do poleceń plugins.
  • Specyfikacje npm dotyczą wyłącznie rejestru: nazwa pakietu z opcjonalną dokładną wersją lub znacznikiem dist-tag. Specyfikacje Git, URL i plików oraz zakresy semver są odrzucane. Zależności są instalowane lokalnie w projekcie z opcją --ignore-scripts.
  • Specyfikacje bez dodatkowych oznaczeń oraz @latest pozostają w kanale stabilnym; jeśli npm wskaże wersję przedpremierową, OpenClaw zatrzyma się i poprosi o jej jawne dopuszczenie (@beta, @rc lub dokładną wersję przedpremierową).
  • Obsługiwane archiwa: .zip, .tgz, .tar.gz, .tar.
  • -l, --link tworzy dowiązanie do katalogu lokalnego zamiast go kopiować (dodaje go do hooks.internal.load.extraDirs); dowiązane pakiety hooków są hookami zarządzanymi z katalogu skonfigurowanego przez operatora, a nie hookami obszaru roboczego.
  • --pin zapisuje instalacje npm jako dokładne, ustalone name@version w hooks.internal.installs.
  • Instalacja kopiuje pakiet do ~/.openclaw/hooks/<id>, włącza jego hooki w hooks.internal.entries.* i zapisuje instalację w hooks.internal.installs.
  • Jeśli zapisany skrót integralności przestanie odpowiadać pobranemu artefaktowi, OpenClaw wyświetli ostrzeżenie i poprosi o potwierdzenie przed kontynuowaniem; użyj globalnej opcji --yes, aby pominąć pytanie (na przykład w CI).

​
Dołączone hooki

Włącz dowolny dołączony hook za pomocą openclaw hooks enable <hook-name>. Pełne informacje, klucze konfiguracji i wartości domyślne: Dołączone hooki.

​
Plik dziennika command-logger

​
Uwagi

  • hooks list --json, info --json i check --json zapisują ustrukturyzowany kod JSON bezpośrednio na standardowe wyjście.

​
Powiązane