Plugin dziennika

Plugin Logbook przekształca aktywność na ekranie w automatyczny dziennik pracy. Okresowo przechwytuje zrzuty ekranu ze sparowanego węzła, podsumowuje je w postaci obserwacji ze znacznikami czasu i tworzy karty osi czasu w interfejsie sterowania. Może także generować codzienne notatki na spotkanie statusowe i odpowiadać na pytania dotyczące śledzonego dnia.

Stan należący do OpenClaw pozostaje na Gateway w <state-dir>/logbook/, ale przetwarzanie przez modele nie musi odbywać się lokalnie. Wybrane zrzuty ekranu są wysyłane do skonfigurowanej trasy modelu wizyjnego, a obserwacje i tekst osi czasu — do domyślnego modelu agenta. Jeśli zawartość ekranu i utworzony na jej podstawie opis aktywności muszą pozostać na komputerze, użyj lokalnych tras modeli na obu etapach.

Logbook jest dołączony, ale domyślnie wyłączony. Włączenie Pluginu oznacza zgodę na przechwytywanie ekranu przez Gateway, ponieważ captureEnabled ma domyślnie wartość true.

Zanim zaczniesz

Potrzebujesz:

• Połączonego węzła udostępniającego screen.snapshot lub logbook.snapshot. Węzeł aplikacji macOS wymaga uprawnienia do nagrywania ekranu. Bezinterfejsowy host węzła macOS (openclaw node host run) otrzymuje udostępniane przez Plugin polecenie logbook.snapshot, korzystające z systemowego narzędzia screencapture.
• Włączonego i uwierzytelnionego dołączonego Pluginu Codex. Obecnie Codex zapewnia kontrakt ustrukturyzowanego wyodrębniania z obrazów wymagany przez Logbook. Zaloguj się za pomocą openclaw models auth login --provider openai; inne metody uwierzytelniania opisano w sekcji Środowisko uruchomieniowe Codex.
• Działającego domyślnego modelu agenta. Po przejściu modelu wizyjnego Logbook używa go do syntezowania kart, notatek na spotkanie statusowe oraz odpowiedzi na pytania dotyczące dnia.

Szybki start

Włącz Pluginy Codex i Logbook:

openclaw plugins enable codexopenclaw plugins enable logbook

Skonfiguruj jawnie model wizyjny, aby zapewnić deterministyczne uruchamianie:

{  plugins: {    entries: {      codex: {        enabled: true,      },      logbook: {        enabled: true,        config: {          visionModel: "codex/gpt-5.6-sol",        },      },    },  },}

Jeśli używasz plugins.allow, uwzględnij zarówno codex, jak i logbook. Po zmianie konfiguracji Pluginu uruchom ponownie Gateway, a następnie sprawdź rejestracje i otwórz panel:

openclaw gateway restartopenclaw plugins inspect logbook --runtime --jsonopenclaw nodes status --connectedopenclaw nodes describe --node <idOrNameOrIp>openclaw dashboard

Opis węzła musi zawierać screen.snapshot lub logbook.snapshot. Węzły bezinterfejsowe ogłaszają logbook.snapshot dopiero po aktywowaniu Pluginu. Jeśli brakuje polecenia, zobacz Rozwiązywanie problemów z węzłami.

Karta Logbook pojawia się tylko przy włączonym Pluginie i sesji interfejsu sterowania z zakresem operator.write. Wiersz stanu powinien pokazywać Przechwytywanie bez błędu. Karta osi czasu pojawia się po zamknięciu okna analizy; po przechwyceniu aktywności możesz też wybrać Analizuj teraz.

Jak to działa

1. Przechwytywanie: co captureIntervalSeconds (domyślnie 30 s) Logbook wywołuje polecenie przechwytywania wybranego węzła i zapisuje przeskalowaną klatkę JPEG. Kolejne identyczne klatki są oznaczane jako bezczynne i wykluczane z analizy.
2. Obserwacja: po upływie okna analizy (domyślnie 15 minut) Plugin wybiera maksymalnie 16 aktywnych klatek i wysyła je do modelu wizyjnego, który zwraca obserwacje aktywności ze znacznikami czasu („VS Code: edytowanie store.ts, naprawianie błędu typu”). Bieżące okno zamyka również przerwa w przechwytywaniu dłuższa niż dwie minuty lub lokalna północ.
3. Synteza: obserwacje wraz z kartami z ostatnich 45 minut są przekształcane w karty osi czasu (po 10–60 minut każda) zawierające tytuł, podsumowanie, kategorię, główną aplikację i krótkie rozproszenia uwagi.
4. Czyszczenie: klatki starsze niż retentionDays (domyślnie 14) są usuwane. Karty, obserwacje i zapisane w pamięci podręcznej notatki na spotkania statusowe są zachowywane.

Granice dni i zegary osi czasu używają lokalnej strefy czasowej Gateway, a nie strefy czasowej przeglądarki. Klatki i baza danych SQLite osi czasu znajdują się w <state-dir>/logbook/.

Przepływ modeli i danych

Logbook używa dwóch oddzielnych tras modeli:

Pełna baza danych SQLite nie jest wysyłana do żadnego modelu. Surowe zrzuty ekranu trafiają wyłącznie do etapu obserwacji; synteza kart, notatka statusowa i odpowiedzi na pytania otrzymują tekst utworzony na ich podstawie.

Konfiguracja

{  plugins: {    entries: {      codex: {        enabled: true,      },      logbook: {        enabled: true,        config: {          captureEnabled: true,          captureIntervalSeconds: 30,          analysisIntervalMinutes: 15,          nodeId: "my-mac",          screenIndex: 0,          maxWidth: 1440,          visionModel: "codex/gpt-5.6-sol",          retentionDays: 14,        },      },    },  },}

Wszystkie klucze konfiguracji Logbook są opcjonalne. Wartości liczbowe są zaokrąglane do liczb całkowitych i ograniczane do obsługiwanego zakresu.

Bez nodeId Logbook preferuje połączony węzeł aplikacji udostępniający screen.snapshot, a następnie używa węzła bezinterfejsowego udostępniającego logbook.snapshot. W konfiguracji bez przypiętego węzła węzeł, na którym wystąpił błąd, jest przesuwany za inne kwalifikujące się węzły. Przełącznik wstrzymania w panelu obowiązuje tylko w bieżącej sesji i jest resetowany po ponownym uruchomieniu Gateway; aby trwale zatrzymać działanie, użyj captureEnabled: false.

Wybór modelu wizyjnego

Logbook wybiera model obserwacji w następującej kolejności:

1. plugins.entries.logbook.config.visionModel
2. pierwszy wpis Codex obsługujący obrazy w tools.media.image.models
3. pierwszy wpis Codex obsługujący obrazy w tools.media.models

Inni dostawcy multimediów są pomijani, ponieważ obecnie nie udostępniają kontraktu ustrukturyzowanego wyodrębniania wymaganego przez Logbook. Ustawienie tools.media.image.enabled: false wyłącza zapożyczone domyślne modele multimediów, ale jawny visionModel Logbook nadal obowiązuje.

Karta panelu

• Oś czasu: rozwijane karty poszczególnych aktywności z kolorami kategorii, główną aplikacją, znacznikami rozproszeń uwagi i klatką kluczową zrzutu.
• Dzień w skrócie: współczynnik skupienia, podział na kategorie, najczęściej używane aplikacje.
• Codzienna notatka statusowa: przekształca dane z wczoraj i dziś w gotową do wklejenia aktualizację.
• Zapytaj o swój dzień: pytania w języku naturalnym, na które odpowiedzi są tworzone na podstawie śledzonej osi czasu („kiedy sprawdzałem żądanie ściągnięcia dotyczące Gateway?”).
• Analizuj teraz: natychmiast zamyka bieżące okno przechwytywania zamiast czekać na upływ interwału analizy.

Metody Gateway

Logbook rejestruje następujące metody RPC Gateway:

Metody odczytu zwracają stan operacyjny lub utworzony tekst. Dostęp do surowych pikseli zrzutów ekranu, operacje powodujące użycie płatnych modeli i modyfikacje środowiska uruchomieniowego wymagają operator.write. Karta interfejsu sterowania również wymaga operator.write, ponieważ udostępnia te operacje i podgląd surowych klatek; klient tylko do odczytu nadal może bezpośrednio wywoływać metody zwracające utworzony tekst.

Uwagi dotyczące prywatności

• Zrzuty mogą zawierać wszystko, co znajduje się na ekranie, w tym dane poufne. Klatki nie opuszczają komputera poza przypadkiem, gdy wybrane próbki są wysyłane do skonfigurowanego modelu obserwacji.
• Obserwacje, najnowsze karty i pytania mogą opuścić komputer za pośrednictwem domyślnego modelu agenta podczas syntezy kart, generowania notatki statusowej lub odpowiadania na pytania. Zastosuj zasady dostawcy dotyczące przetwarzania danych do obu tras modeli.
• Jeśli potrzebujesz w pełni lokalnego potoku, użyj lokalnych tras zarówno dla ustrukturyzowanego modelu obserwacji, jak i domyślnego modelu agenta.
• Klatki, baza danych osi czasu i tymczasowe przechwycenia są zapisywane z uprawnieniami dostępu wyłącznie dla właściciela.
• Dodanie screen.snapshot do gateway.nodes.denyCommands działa jako wyłącznik przechwytywania ekranu: blokuje zarówno przechwytywanie przez węzeł aplikacji, jak i własne polecenie Logbook logbook.snapshot.
• Ustawienie tools.media.image.enabled: false uniemożliwia również Logbook korzystanie z zapożyczonych modeli obrazu do analizy; wówczas używany jest wyłącznie jawny visionModel z konfiguracji Pluginu.

Rozwiązywanie problemów

Brak karty Logbook

Sprawdź wszystkie trzy warunki:

1. openclaw plugins list --enabled zawiera logbook.
2. Gateway został ponownie uruchomiony po zmianie Pluginu lub listy dozwolonych Pluginów.
3. Połączenie interfejsu sterowania ma zakres operator.write; sesje tylko do odczytu nie otrzymują deskryptora interaktywnej karty.

Jeśli ustawiono plugins.allow, zalecana konfiguracja wymaga uwzględnienia w niej zarówno logbook, jak i codex.

Przechwytywanie zgłasza błąd

openclaw nodes status --connectedopenclaw nodes describe --node <idOrNameOrIp>openclaw logs --follow

• Upewnij się, że węzeł udostępnia screen.snapshot lub logbook.snapshot.
• Przyznaj uprawnienie do nagrywania ekranu na komputerze Mac wykonującym przechwytywanie.
• Jeśli skonfigurowano nodeId, upewnij się, że odpowiada identyfikatorowi węzła lub jego nazwie wyświetlanej.
• Sprawdź, czy gateway.nodes.denyCommands nie zawiera screen.snapshot.

Po trzech kolejnych niepowodzeniach Logbook wstrzymuje działanie na dziesięć cykli przechwytywania, a następnie ponawia próbę. Konfiguracja bez przypisanego węzła może przełączyć się na inny kwalifikujący się węzeł.

Przechwytywanie działa, ale nie pojawiają się żadne karty

• Stan Brak modelu oznacza, że nie znaleziono zgodnej trasy ustrukturyzowanego przetwarzania obrazu. Włącz i uwierzytelnij plugin Codex albo ustaw prawidłową, jawną wartość visionModel. Przechwycone klatki pozostają oczekujące, gdy brakuje modelu, i mogą zostać przeanalizowane po poprawieniu konfiguracji.
• Poczekaj przez czas określony przez analysisIntervalMinutes albo wybierz Analizuj teraz po przechwyceniu aktywności.
• Kolejne identyczne klatki stanowią dowód bezczynności i nie trafiają do partii analizy. Przed testowaniem zmień widoczną zawartość ekranu.
• Jeśli najnowsza partia zawiera błąd, rozwiąż problem z modelem lub uwierzytelnianiem i wybierz Analizuj teraz. Ponawianie nieudanych partii następuje wyłącznie po tym jawnym działaniu, aby uniknąć wielokrotnego naliczania kosztów użycia modelu.

Powiązane

• Zarządzanie pluginami
• Środowisko Codex
• Rozpoznawanie multimediów
• Węzły
• Rozwiązywanie problemów z węzłami
• Interfejs sterowania