Logboekplugin

De Logbook-plugin zet schermactiviteit om in een automatisch werklogboek. Het maakt periodiek schermopnamen van een gekoppelde Node, vat deze samen in waarnemingen met tijdstempels en bouwt tijdlijnkaarten in de Control UI. Het 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 visuele route; waarnemingen en tijdlijntekst gaan naar het standaard agentmodel. Gebruik lokale modelroutes voor beide fasen als scherminhoud en afgeleide activiteitstekst op de machine moeten blijven.

Logbook wordt meegeleverd en is standaard uitgeschakeld. Als u de plugin inschakelt, stemt u ermee in dat de Gateway schermopnamen maakt, omdat captureEnabled standaard true is.

Voordat u begint

U hebt het volgende nodig:

• Een verbonden Node die screen.snapshot of logbook.snapshot aanbiedt. De macOS-app-Node heeft toestemming voor schermopname 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 u aan met openclaw models auth login --provider openai; zie Codex-harnas voor andere authenticatieroutes.
• Een werkend standaard agentmodel. Logbook gebruikt dit na de visuele verwerking om kaarten, stand-upnotities en vragen en antwoorden over de dag te genereren.

Snelstart

Schakel de Codex- en Logbook-plugins in:

openclaw plugins enable codexopenclaw plugins enable logbook

Configureer een expliciet visueel model voor deterministisch opstarten:

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

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

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

De Node-beschrijving moet screen.snapshot of logbook.snapshot bevatten. Headless Nodes bieden logbook.snapshot pas aan nadat de plugin actief is. Zie Problemen met Nodes oplossen als de opdracht ontbreekt.

Het tabblad Logbook verschijnt alleen bij een ingeschakelde plugin en een Control UI-sessie met operator.write. De statusrij moet zonder foutmelding Vastleggen tonen. Er verschijnt een tijdlijnkaart wanneer het analysevenster sluit, of u kunt Nu analyseren selecteren nadat activiteit is vastgelegd.

Hoe het werkt

1. Vastleggen: elke captureIntervalSeconds (standaard 30 s) 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.
2. Waarnemen: zodra een analysevenster (standaard 15 minuten) is verstreken, bemonstert de plugin maximaal 16 actieve frames en stuurt deze naar het visuele model, dat activiteitswaarnemingen met tijdstempels retourneert ("VS Code: store.ts bewerken, een typefout herstellen"). Een vastlegonderbreking van meer dan twee minuten of lokale middernacht sluit ook het huidige venster.
3. 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.
4. Opschonen: frames ouder dan retentionDays (standaard 14) worden verwijderd. Kaarten, waarnemingen en gecachte stand-ups blijven behouden.

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

Model- en gegevensstroom

Logbook gebruikt twee afzonderlijke modelroutes:

De volledige SQLite-database wordt niet naar een van beide modellen verzonden. Onbewerkte schermafbeeldingen gaan alleen naar de waarnemingsfase; het samenstellen van kaarten, 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.

Zonder nodeId geeft Logbook de voorkeur aan een verbonden app-Node die screen.snapshot aanbiedt en valt het vervolgens terug op een headless Node die logbook.snapshot aanbiedt. 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 gereset wanneer de Gateway opnieuw start; gebruik captureEnabled: false voor een permanente stop.

Selectie van visueel model

Logbook bepaalt het waarnemingsmodel in deze volgorde:

1. plugins.entries.logbook.config.visionModel
2. de eerste Codex-vermelding met afbeeldingsondersteuning onder tools.media.image.models
3. de eerste Codex-vermelding met afbeeldingsondersteuning onder tools.media.models

Andere mediaproviders worden overgeslagen omdat zij momenteel niet het contract voor gestructureerde extractie aanbieden dat Logbook vereist. Als u tools.media.image.enabled: false instelt, worden geleende mediastandaarden uitgeschakeld, maar een expliciete Logbook-waarde voor visionModel blijft van toepassing.

Dashboardtabblad

• Tijdlijn: uitvouwbare kaarten per activiteit met categoriekleuren, de hoofdapp, afleidingslabels en een belangrijk snapshotframe.
• Dag in één oogopslag: focusverhouding, uitsplitsing per categorie, meest gebruikte apps.
• Dagelijkse stand-up: zet gisteren en vandaag om in een kant-en-klare update.
• Vragen over uw dag: vragen in natuurlijke taal die worden beantwoord op basis van de bijgehouden tijdlijn ("wanneer heb ik de Gateway-PR 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:

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

Privacyopmerkingen

• Opnamen kunnen alles bevatten wat op het scherm staat, inclusief geheimen. Frames verlaten de machine nooit, behalve als bemonsterde invoer voor het geconfigureerde waarnemingsmodel.
• Waarnemingen, recente kaarten en vragen kunnen via het standaard agentmodel de machine verlaten tijdens het samenstellen van kaarten, het genereren van stand-ups of vragen en antwoorden. Pas het gegevensverwerkingsbeleid van de provider toe op beide modelroutes.
• Gebruik lokale routes voor zowel het gestructureerde waarnemingsmodel als het standaard agentmodel wanneer u een volledig lokale pijplijn nodig hebt.
• Frames, de tijdlijndatabase en tijdelijke opnamen worden geschreven met bestandsmachtigingen die alleen toegang aan de eigenaar geven.
• Het toevoegen van screen.snapshot aan gateway.nodes.denyCommands is de noodstop voor schermopname: deze blokkeert zowel opname via app-Nodes als Logbooks eigen opdracht logbook.snapshot.
• Als u tools.media.image.enabled: false instelt, stopt Logbook ook met het lenen van de media-afbeeldingsmodellen voor analyse; dan wordt alleen een expliciete visionModel in de pluginconfiguratie gebruikt.

Problemen oplossen

Het Logbook-tabblad ontbreekt

Controleer alle drie de voorwaarden:

1. openclaw plugins list --enabled bevat logbook.
2. De Gateway is opnieuw gestart na de wijziging van de plugin of toelatingslijst.
3. De Control UI-verbinding heeft operator.write; alleen-lezensessies ontvangen de interactieve tabbladbeschrijving niet.

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

Vastleggen meldt een fout

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

• Controleer of de Node screen.snapshot of logbook.snapshot beschikbaar stelt.
• Verleen toestemming voor Screen Recording op de Mac die de opname maakt.
• Als nodeId is geconfigureerd, controleer dan of deze overeenkomt met de Node-id of weergavenaam.
• Controleer of gateway.nodes.denyCommands niet screen.snapshot bevat.

Na drie opeenvolgende fouten past Logbook gedurende tien vastlegintervallen een vertraging toe en probeert het daarna opnieuw. Een niet-vastgezette configuratie kan overschakelen naar een andere geschikte Node.

Vastleggen lukt, 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 geldig expliciet visionModel in. Vastgelegde frames blijven in behandeling zolang het model ontbreekt en kunnen worden geanalyseerd nadat de configuratie is hersteld.
• Wacht gedurende analysisIntervalMinutes of selecteer Nu analyseren nadat activiteit is vastgelegd.
• Opeenvolgende identieke frames gelden als bewijs van inactiviteit en worden niet opgenomen in analysebatches. Wijzig het zichtbare scherm voordat u test.
• Als de nieuwste batch een fout toont, los dan het probleem met het model of de authenticatie op en selecteer Nu analyseren. Mislukte batches worden alleen opnieuw geprobeerd na die expliciete actie om herhaalde modelkosten te voorkomen.

Gerelateerd

• Plugins beheren
• Codex-harnas
• Media begrijpen
• Nodes
• Problemen met Nodes oplossen
• Besturingsinterface