Logboek-Plugin

De Logbook-plugin zet schermactiviteit om in een automatisch werkjournaal. De plugin legt periodiek schermafbeeldingen van een gekoppelde Node vast, vat deze samen als waarnemingen met tijdstempels en bouwt tijdlijnkaarten in de Control UI. De plugin kan ook dagelijkse stand-upnotities genereren en vragen over een bijgehouden dag beantwoorden. Door OpenClaw beheerde status blijft op de Gateway onder <state-dir>/logbook/, maar modelverwerking vindt niet noodzakelijk lokaal plaats. Bemonsterde schermafbeeldingen gaan naar de geconfigureerde visieroute; waarnemingen en tijdlijntekst gaan naar het standaardmodel van de agent. Gebruik voor beide fasen lokale modelroutes als scherminhoud en afgeleide activiteitstekst op de machine moeten blijven. Logbook is meegeleverd en standaard uitgeschakeld. Als je de plugin inschakelt, stemt de Gateway in met schermopname, omdat captureEnabled standaard true is.

Voordat je begint

Je hebt het volgende nodig:

Een verbonden Node die screen.snapshot of logbook.snapshot beschikbaar stelt. De macOS-app-Node heeft toestemming voor Screen Recording nodig. Een headless macOS-Node-host (openclaw node host run) krijgt de door de plugin geleverde opdracht logbook.snapshot, die gebruikmaakt van het systeemhulpmiddel screencapture.
De meegeleverde Codex-plugin, ingeschakeld en geauthenticeerd. Codex biedt momenteel het contract voor gestructureerde afbeeldingsextractie dat Logbook vereist. Meld je aan met openclaw models auth login --provider openai; zie Codex-harnas voor andere authenticatieroutes.
Een werkend standaardmodel voor de agent. Logbook gebruikt dit na de visiefase om kaarten, stand-upnotities en vragen en antwoorden over een dag samen te stellen.

Snelstart

Schakel de Codex- en Logbook-plugins in:

openclaw plugins enable codex
openclaw plugins enable logbook

Configureer een expliciet visiemodel voor deterministisch opstarten:

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

Als je plugins.allow gebruikt, neem dan zowel codex als logbook op. Start de Gateway opnieuw nadat je de pluginconfiguratie hebt gewijzigd, inspecteer vervolgens de registraties en open het dashboard:

openclaw gateway restart
openclaw plugins inspect logbook --runtime --json
openclaw nodes status --connected
openclaw nodes describe --node <idOrNameOrIp>
openclaw dashboard

De Node-beschrijving moet screen.snapshot of logbook.snapshot bevatten. Headless Nodes adverteren logbook.snapshot pas nadat de plugin actief is. Zie Problemen met Nodes oplossen als de opdracht ontbreekt. Het tabblad Logbook verschijnt alleen voor een ingeschakelde plugin en een operator.write- sessie van de Control UI. De statusrij moet zonder fout Vastleggen tonen. Er verschijnt een tijdlijnkaart wanneer het analysevenster sluit, of je kunt Nu analyseren selecteren nadat activiteit is vastgelegd.

Werking

Vastleggen: elke captureIntervalSeconds (standaard 30s) roept Logbook de vastlegopdracht van de geselecteerde Node aan en slaat het een geschaald JPEG-frame op. Opeenvolgende identieke frames worden als inactief gemarkeerd en van analyse uitgesloten.
Waarnemen: zodra een analysevenster (standaard 15 minuten) is verstreken, bemonstert de plugin maximaal 16 actieve frames en stuurt deze naar het visiemodel, dat activiteitswaarnemingen met tijdstempels retourneert (“VS Code: bezig met het bewerken van store.ts en het oplossen van een typefout”). Een onderbreking in het vastleggen van meer dan twee minuten of lokale middernacht sluit ook het huidige venster.
Samenstellen: waarnemingen plus de laatste 45 minuten aan bestaande kaarten worden herzien tot tijdlijnkaarten (elk 10-60 minuten) met een titel, samenvatting, categorie, hoofdapp en eventuele korte afleidingen.
Opschonen: frames ouder dan retentionDays (standaard 14) worden verwijderd. Kaarten, waarnemingen en gecachte stand-ups blijven bewaard.

Daggrenzen en tijdlijnklokken gebruiken de lokale tijdzone van de Gateway, niet de tijdzone van de browser. Frames en de SQLite-tijdlijndatabase bevinden zich onder <state-dir>/logbook/.

Model- en gegevensstroom

Logbook gebruikt twee afzonderlijke modelroutes:

Fase	Verzonden gegevens	Modelroute
Waarnemen	Maximaal 16 bemonsterde JPEG-frames plus hun vastlegtijden	`visionModel`, of een compatibel geleend Codex-item `tools.media`
Kaarten samenstellen	Waarnemingen met tijdstempels en recente tijdlijnkaarten	Standaardmodel van de agent via de LLM-runtime van de plugin
Stand-up genereren	Kaarten voor de geselecteerde dag en de vorige dag	Standaardmodel van de agent via de LLM-runtime van de plugin
Vragen over je dag	De vraag, kaarten van de geselecteerde dag en recente waarnemingen	Standaardmodel van de agent via de LLM-runtime van de plugin

De volledige SQLite-database wordt niet naar een van beide modellen verzonden. Onbewerkte schermafbeeldingen gaan alleen naar de waarnemingsfase; kaartsamenstelling, stand-up en vragen en antwoorden ontvangen afgeleide tekst.

Configuratie

{
  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,
        },
      },
    },
  },
}

Alle Logbook-configuratiesleutels zijn optioneel. Numerieke waarden worden afgerond op gehele getallen en begrensd tot het ondersteunde bereik.

Sleutel	Standaard	Bereik of waarden	Gedrag
`captureEnabled`	`true`	booleaans	Permanente hoofdschakelaar voor nieuwe momentopnamen; de tijdlijn blijft beschikbaar wanneer `false`
`captureIntervalSeconds`	`30`	`5`-`600`	Vertraging tussen vastlegpogingen
`analysisIntervalMinutes`	`15`	`3`-`120`	Beoogd waarnemingsvenster; onderbrekingen en middernacht kunnen het eerder sluiten
`nodeId`	niet ingesteld	Node-id of weergavenaam	Zet vastleggen vast op één verbonden Node; vergelijking is niet hoofdlettergevoelig
`screenIndex`	`0`	`0`-`16`	Nulgebaseerde schermindex
`maxWidth`	`1440`	`480`-`3840`	Aangevraagde limiet voor vastlegformaat; headless macOS past deze toe op de grootste dimensie
`visionModel`	niet ingesteld	`provider/model`	Expliciete gestructureerde route; onjuist gevormde verwijzingen pauzeren de analyse, niet-ondersteunde providers laten batches mislukken
`retentionDays`	`14`	`1`-`365`	Verwijdert oude frames; kaarten, waarnemingen en stand-ups blijven behouden

Zonder nodeId geeft Logbook de voorkeur aan een verbonden app-Node die screen.snapshot beschikbaar stelt en valt het daarna terug op een headless Node die logbook.snapshot beschikbaar stelt. In een niet-vastgezette configuratie wordt een mislukte Node achter andere geschikte Nodes geplaatst. De pauzeschakelaar op het dashboard geldt alleen voor de sessie en wordt opnieuw ingesteld wanneer de Gateway opnieuw start; gebruik captureEnabled: false voor een permanente stop.

Selectie van visiemodel

Logbook bepaalt het waarnemingsmodel in deze volgorde:

plugins.entries.logbook.config.visionModel
het eerste Codex-item met afbeeldingsondersteuning onder tools.media.models

Andere mediaproviders worden overgeslagen omdat ze momenteel niet het contract voor gestructureerde extractie beschikbaar stellen dat Logbook vereist. Het instellen van tools.media.image.enabled: false schakelt geleende mediastandaarden uit, maar een expliciete Logbook-instelling visionModel blijft van toepassing.

Dashboardtabblad

Tijdlijn: uitvouwbare kaarten per activiteit met categoriekleuren, de hoofdapp, afleidingslabels en een sleutelframe van een momentopname.
Dag in één oogopslag: focusverhouding, categorieverdeling, meest gebruikte apps.
Dagelijkse stand-up: zet gisteren plus vandaag om in een kant-en-klare update.
Vragen over je dag: vragen in natuurlijke taal, beantwoord vanuit de bijgehouden tijdlijn (“wanneer heb ik de pull request voor de Gateway beoordeeld?”).
Nu analyseren: sluit het huidige vastlegvenster onmiddellijk in plaats van op het analyse-interval te wachten.

Gateway-methoden

Logbook registreert deze RPC-methoden van de Gateway:

Methode	Parameters	Bereik	Resultaat
`logbook.status`	geen	`operator.read`	Status van vastleggen, analyse, model, Node, Gateway-dag en Gateway-tijdzone
`logbook.days`	geen	`operator.read`	Dagen met aantallen tijdlijnkaarten en tijdsgrenzen van kaarten
`logbook.timeline`	`{ day?: "YYYY-MM-DD" }`	`operator.read`	Afgeleide kaarten en dagstatistieken; standaard de huidige dag van de Gateway
`logbook.frames`	`{ startMs, endMs }`	`operator.write`	Framemetadata binnen het aangevraagde bereik in epoch-milliseconden
`logbook.frame`	`{ frameId }`	`operator.write`	Eén onbewerkt JPEG-frame als base64
`logbook.standup`	`{ day?, refresh? }`	`operator.write`	Gecachte of opnieuw gegenereerde stand-uptekst voor een dag
`logbook.ask`	`{ day?, question }`	`operator.write`	Op de tijdlijn gebaseerd antwoord voor een dag
`logbook.capture.set`	`{ paused }`	`operator.write`	Pauzestatus die alleen voor de sessie geldt en bijgewerkte status
`logbook.analyze.now`	geen	`operator.write`	Start een wachtende analyse of retourneert waarom deze niet kon starten

De leesmethoden retourneren de operationele status of afgeleide tekst. Onbewerkte schermafbeeldingspixels, acties die modelkosten veroorzaken en runtimewijzigingen vereisen operator.write. Het tabblad van de Control UI vereist ook operator.write, omdat het deze acties en voorbeelden van onbewerkte frames beschikbaar stelt; een alleen-lezenclient kan de methoden voor afgeleide tekst nog steeds rechtstreeks aanroepen.

Privacyopmerkingen

Momentopnamen kunnen alles bevatten wat op het scherm staat, inclusief geheimen. Frames verlaten de machine nooit, behalve als bemonsterde invoer voor het geconfigureerde observatiemodel.
Observaties, recente kaarten en vragen kunnen de machine verlaten via het standaard agentmodel tijdens het samenstellen van kaarten, het genereren van stand-ups of vraag-en-antwoordinteracties. Pas het gegevensverwerkingsbeleid van de provider toe op beide modelroutes.
Gebruik lokale routes voor zowel het gestructureerde observatiemodel als het standaard agentmodel wanneer je een volledig lokale pijplijn nodig hebt.
Frames, de tijdlijndatabase en tijdelijke opnamen worden opgeslagen met bestandsmachtigingen die alleen de eigenaar toegang geven.
Het toevoegen van screen.snapshot aan gateway.nodes.commands.deny is de noodstop voor schermopnamen: hiermee worden zowel opnamen door app-nodes als Logbooks eigen opdracht logbook.snapshot geblokkeerd.
Het instellen van tools.media.image.enabled: false voorkomt ook dat Logbook de media-afbeeldingsmodellen voor analyse gebruikt; dan wordt alleen een expliciete visionModel in de Pluginconfiguratie gebruikt.

Problemen oplossen

Het tabblad Logbook ontbreekt

Controleer alle drie de voorwaarden:

openclaw plugins list --enabled bevat logbook.
De Gateway is opnieuw gestart na de wijziging van de Plugin of toelatingslijst.
De Control UI-verbinding heeft operator.write; alleen-lezen-sessies ontvangen de interactieve tabbladbeschrijving niet.

Als plugins.allow is ingesteld, moet deze voor de aanbevolen configuratie zowel logbook als codex bevatten.

Er wordt een fout gemeld bij de opname

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

Controleer of de node screen.snapshot of logbook.snapshot beschikbaar stelt.
Verleen op de Mac die de opname maakt toestemming voor schermopname.
Als nodeId is geconfigureerd, controleer dan of deze overeenkomt met de node-id of weergavenaam.
Controleer of gateway.nodes.commands.deny niet screen.snapshot bevat.

Na drie opeenvolgende fouten wacht Logbook tien opname-intervallen en probeert het daarna opnieuw. Een niet-vastgezette configuratie kan overschakelen naar een andere geschikte node.

Opnamen slagen, maar er verschijnen geen kaarten

De status Model ontbreekt betekent dat er geen compatibele route voor gestructureerde visuele analyse is gevonden. Schakel de Codex-Plugin in en verifieer deze, of stel een geldige expliciete visionModel in. Opgenomen frames blijven in behandeling zolang het model ontbreekt en kunnen worden geanalyseerd nadat de configuratie is hersteld.
Wacht op analysisIntervalMinutes of selecteer Nu analyseren nadat activiteit is opgenomen.
Opeenvolgende identieke frames gelden als bewijs van inactiviteit en worden niet opgenomen in analysebatches. Wijzig de zichtbare scherminhoud voordat je test.
Als de nieuwste batch een fout toont, los je het probleem met het model of de authenticatie op en selecteer je Nu analyseren. Mislukte batches worden alleen na die expliciete actie opnieuw geprobeerd om herhaaldelijke modelkosten te voorkomen.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Voordat je begint

Snelstart

Werking

Model- en gegevensstroom

Configuratie

Selectie van visiemodel

Dashboardtabblad

Gateway-methoden

Privacyopmerkingen

Problemen oplossen

Het tabblad Logbook ontbreekt

Er wordt een fout gemeld bij de opname

Opnamen slagen, maar er verschijnen geen kaarten

Gerelateerd

​Voordat je begint

​Snelstart

​Werking

​Model- en gegevensstroom

​Configuratie

​Selectie van visiemodel

​Dashboardtabblad

​Gateway-methoden

​Privacyopmerkingen

​Problemen oplossen

​Het tabblad Logbook ontbreekt

​Er wordt een fout gemeld bij de opname

​Opnamen slagen, maar er verschijnen geen kaarten

​Gerelateerd

Voordat je begint

Snelstart

Werking

Model- en gegevensstroom

Configuratie

Selectie van visiemodel

Dashboardtabblad

Gateway-methoden

Privacyopmerkingen

Problemen oplossen

Het tabblad Logbook ontbreekt

Er wordt een fout gemeld bij de opname

Opnamen slagen, maar er verschijnen geen kaarten

Gerelateerd