Logbuch-Plugin

​

Bevor Sie beginnen

• Einen verbundenen Node, der screen.snapshot oder logbook.snapshot bereitstellt. Der Node der macOS-App benötigt die Berechtigung zur Bildschirmaufnahme. Ein headless betriebener macOS-Node-Host (openclaw node host run) erhält den vom Plugin bereitgestellten Befehl logbook.snapshot, der auf dem Systemwerkzeug screencapture basiert.
• Das gebündelte Codex-Plugin muss aktiviert und authentifiziert sein. Codex stellt derzeit den strukturierten Bildextraktionsvertrag bereit, den Logbook benötigt. Melden Sie sich mit openclaw models auth login --provider openai an; weitere Authentifizierungswege finden Sie unter Codex-Harness.
• Ein funktionsfähiges standardmäßiges Agentenmodell. Logbook verwendet es nach der Vision-Verarbeitung, um Karten, Standup- Notizen und Fragen und Antworten zum Tag zu synthetisieren.

​

Schnellstart

openclaw plugins enable codex
openclaw plugins enable logbook

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

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

​

Funktionsweise

1. Erfassen: Alle captureIntervalSeconds (standardmäßig 30s) ruft Logbook den Erfassungsbefehl des ausgewählten Nodes auf und speichert ein skaliertes JPEG-Bild. Aufeinanderfolgende identische Bilder werden als inaktiv markiert und von der Analyse ausgeschlossen.
2. Beobachten: Sobald ein Analysefenster (standardmäßig 15 Minuten) abgelaufen ist, wählt das Plugin bis zu 16 aktive Bilder aus und sendet sie an das Vision-Modell, das mit Zeitstempeln versehene Aktivitätsbeobachtungen zurückgibt („VS Code: Bearbeiten von store.ts, Beheben eines Typfehlers“). Eine Erfassungslücke von mehr als zwei Minuten oder die lokale Mitternacht schließt ebenfalls das aktuelle Fenster.
3. Synthetisieren: Beobachtungen sowie die vorhandenen Karten der letzten 45 Minuten werden zu Zeitleistenkarten (jeweils 10-60 Minuten) mit Titel, Zusammenfassung, Kategorie, Haupt-App und etwaigen kurzen Ablenkungen überarbeitet.
4. Bereinigen: Bilder, die älter als retentionDays (standardmäßig 14) sind, werden gelöscht. Karten, Beobachtungen und zwischengespeicherte Standups bleiben erhalten.

​

Modell- und Datenfluss

​

Konfiguration

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

​

Auswahl des Vision-Modells

1. plugins.entries.logbook.config.visionModel
2. den ersten bildfähigen Codex-Eintrag unter tools.media.models

​

Dashboard-Registerkarte

• Zeitleiste: Erweiterbare Karten pro Aktivität mit Kategoriefarben, der Haupt- App, Ablenkungsmarkierungen und einem Schlüsselbild.
• Tagesüberblick: Fokusanteil, Kategorieaufschlüsselung, meistgenutzte Apps.
• Tägliches Standup: Wandelt gestern und heute in eine direkt einfügbare Aktualisierung um.
• Fragen Sie nach Ihrem Tag: Fragen in natürlicher Sprache, die anhand der erfassten Zeitleiste beantwortet werden („Wann habe ich den Gateway-PR geprüft?“).
• Jetzt analysieren: Schließt das aktuelle Erfassungsfenster sofort, statt auf das Analyseintervall zu warten.

​

Gateway-Methoden

​

Datenschutzhinweise

• Snapshots können alles enthalten, was auf dem Bildschirm angezeigt wird, einschließlich Geheimnissen. Frames verlassen das Gerät niemals, außer als ausgewählte Eingabe für das konfigurierte Beobachtungsmodell.
• Beobachtungen, aktuelle Karten und Fragen können das Gerät während der Kartensynthese, der Standup-Erstellung oder bei Fragen und Antworten über das standardmäßige Agentenmodell verlassen. Wenden Sie die Datenverarbeitungsrichtlinie des Providers auf beide Modellrouten an.
• Verwenden Sie lokale Routen sowohl für das strukturierte Beobachtungsmodell als auch für das standardmäßige Agentenmodell, wenn Sie eine vollständig lokale Pipeline benötigen.
• Frames, die Zeitleistendatenbank und temporäre Aufnahmen werden mit Dateiberechtigungen gespeichert, die ausschließlich dem Eigentümer Zugriff gewähren.
• Das Hinzufügen von screen.snapshot zu gateway.nodes.commands.deny ist der Notausschalter für Bildschirmaufnahmen: Es blockiert sowohl die Aufnahme durch App-Nodes als auch Logbooks eigenen Befehl logbook.snapshot.
• Das Festlegen von tools.media.image.enabled: false verhindert außerdem, dass Logbook die Medienbildmodelle zur Analyse verwendet; dann wird nur ein explizit in der Plugin-Konfiguration festgelegtes visionModel verwendet.

​

Fehlerbehebung

​

Der Logbook-Tab fehlt

1. openclaw plugins list --enabled enthält logbook.
2. Der Gateway wurde nach der Änderung des Plugins oder der Positivliste neu gestartet.
3. Die Verbindung zur Control UI verfügt über operator.write; schreibgeschützte Sitzungen erhalten die interaktive Tab-Beschreibung nicht.

​

Die Aufnahme meldet einen Fehler

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

• Stellen Sie sicher, dass der Node screen.snapshot oder logbook.snapshot bereitstellt.
• Erteilen Sie auf dem aufnehmenden Mac die Berechtigung für Bildschirmaufnahmen.
• Wenn nodeId konfiguriert ist, stellen Sie sicher, dass es mit der Node-ID oder dem Anzeigenamen übereinstimmt.
• Überprüfen Sie, dass gateway.nodes.commands.deny nicht screen.snapshot enthält.

​

Aufnahmen sind erfolgreich, aber es werden keine Karten angezeigt

• Der Status Modell fehlt bedeutet, dass keine kompatible strukturierte Bildverarbeitungsroute gefunden wurde. Aktivieren und authentifizieren Sie das Codex-Plugin oder legen Sie ein gültiges explizites visionModel fest. Aufgenommene Frames bleiben ausstehend, solange das Modell fehlt, und können analysiert werden, nachdem die Konfiguration korrigiert wurde.
• Warten Sie auf analysisIntervalMinutes oder wählen Sie Jetzt analysieren, nachdem Aktivität aufgezeichnet wurde.
• Aufeinanderfolgende identische Frames gelten als Inaktivitätsnachweis und werden nicht in Analysebatches aufgenommen. Ändern Sie vor dem Testen den sichtbaren Bildschirminhalt.
• Wenn der neueste Batch einen Fehler anzeigt, beheben Sie das Modell- oder Authentifizierungsproblem und wählen Sie Jetzt analysieren. Fehlgeschlagene Batches werden nur nach dieser ausdrücklichen Aktion erneut versucht, um wiederholte Modellkosten zu vermeiden.

​

Verwandte Themen

• Plugins verwalten
• Codex-Harness
• Medienverständnis
• Nodes
• Node-Fehlerbehebung
• Control UI