Plugin de journal de bord

Le plugin Logbook transforme l’activité à l’écran en journal de travail automatique. Il capture périodiquement des instantanés d’écran depuis un Node appairé, les résume sous forme d’observations horodatées et crée des cartes chronologiques dans la Control UI. Il peut également générer des notes de réunion quotidienne et répondre à des questions sur une journée suivie. L’état géré par OpenClaw reste sur le Gateway sous <state-dir>/logbook/, mais le traitement par les modèles n’est pas nécessairement local. Les captures d’écran échantillonnées sont envoyées à la route de vision configurée ; les observations et le texte de la chronologie sont envoyés au modèle d’agent par défaut. Utilisez des routes de modèles locales pour les deux étapes si le contenu de l’écran et le texte d’activité dérivé doivent rester sur la machine. Logbook est intégré et désactivé par défaut. L’activation du plugin autorise le Gateway à effectuer des captures d’écran, car captureEnabled vaut true par défaut.

Avant de commencer

Vous avez besoin des éléments suivants :

Un Node connecté qui expose screen.snapshot ou logbook.snapshot. Le Node de l’application macOS nécessite l’autorisation Screen Recording. Un hôte de Node macOS sans interface graphique (openclaw node host run) reçoit la commande logbook.snapshot fournie par le plugin, qui s’appuie sur l’outil système screencapture.
Le plugin Codex intégré, activé et authentifié. Codex fournit actuellement le contrat d’extraction structurée d’images requis par Logbook. Connectez-vous avec openclaw models auth login --provider openai ; consultez l’environnement d’exécution Codex pour connaître les autres méthodes d’authentification.
Un modèle d’agent par défaut fonctionnel. Logbook l’utilise pour synthétiser les cartes, les notes de réunion quotidienne et les questions-réponses sur la journée après l’étape de vision.

Démarrage rapide

Activez les plugins Codex et Logbook :

openclaw plugins enable codex
openclaw plugins enable logbook

Configurez un modèle de vision explicite pour un démarrage déterministe :

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

Si vous utilisez plugins.allow, incluez codex et logbook. Redémarrez le Gateway après avoir modifié la configuration des plugins, puis inspectez les enregistrements et ouvrez le tableau de bord :

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

La description du Node doit inclure screen.snapshot ou logbook.snapshot. Les Nodes sans interface graphique n’annoncent logbook.snapshot qu’après l’activation du plugin. Consultez le dépannage des Nodes si la commande est absente. L’onglet Logbook apparaît uniquement si le plugin est activé et si la session Control UI dispose de operator.write. La ligne d’état doit afficher Capture en cours sans erreur. Une carte chronologique apparaît à la fermeture de la fenêtre d’analyse, ou vous pouvez sélectionner Analyser maintenant après la capture d’une activité.

Fonctionnement

Capture : toutes les captureIntervalSeconds (30 s par défaut), Logbook appelle la commande de capture du Node sélectionné et stocke une image JPEG redimensionnée. Les images consécutives identiques sont marquées comme inactives et exclues de l’analyse.
Observation : une fois une fenêtre d’analyse écoulée (15 minutes par défaut), le plugin échantillonne jusqu’à 16 images actives et les envoie au modèle de vision, qui renvoie des observations d’activité horodatées (« VS Code : modification de store.ts, correction d’une erreur de type »). Une interruption des captures de plus de deux minutes ou le passage à minuit en heure locale ferme également la fenêtre actuelle.
Synthèse : les observations et les cartes existantes des 45 dernières minutes sont révisées pour former des cartes chronologiques (de 10 à 60 minutes chacune) comportant un titre, un résumé, une catégorie, l’application principale et les éventuelles brèves distractions.
Nettoyage : les images datant de plus de retentionDays (14 par défaut) sont supprimées. Les cartes, les observations et les réunions quotidiennes mises en cache sont conservées.

Les limites de journée et les heures de la chronologie utilisent le fuseau horaire local du Gateway, et non celui du navigateur. Les images et la base de données SQLite de la chronologie se trouvent sous <state-dir>/logbook/.

Modèles et flux de données

Logbook utilise deux routes de modèles distinctes :

Étape	Données envoyées	Route du modèle
Observation	Jusqu’à 16 images JPEG échantillonnées avec leurs heures de capture	`visionModel`, ou une entrée Codex `tools.media` compatible empruntée
Synthèse des cartes	Observations horodatées et cartes chronologiques récentes	Modèle d’agent par défaut via l’environnement d’exécution LLM du plugin
Génération de la réunion	Cartes de la journée sélectionnée et de la veille	Modèle d’agent par défaut via l’environnement d’exécution LLM du plugin
Interrogation du jour	Question, cartes du jour sélectionné et observations récentes	Modèle d’agent par défaut via l’environnement d’exécution LLM du plugin

La base de données SQLite complète n’est envoyée à aucun des deux modèles. Les captures d’écran brutes sont uniquement envoyées à l’étape d’observation ; la synthèse des cartes, la réunion quotidienne et les questions-réponses reçoivent du texte dérivé.

Configuration

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

Toutes les clés de configuration de Logbook sont facultatives. Les valeurs numériques sont arrondies à des entiers et limitées à la plage prise en charge.

Clé	Valeur par défaut	Plage ou valeurs	Comportement
`captureEnabled`	`true`	booléen	Interrupteur principal persistant pour les nouveaux instantanés ; la chronologie reste disponible avec la valeur `false`
`captureIntervalSeconds`	`30`	`5`-`600`	Délai entre les tentatives de capture
`analysisIntervalMinutes`	`15`	`3`-`120`	Fenêtre d’observation cible ; les interruptions et minuit peuvent la fermer plus tôt
`nodeId`	non défini	identifiant ou nom du Node	Limite la capture à un Node connecté ; la correspondance ne tient pas compte de la casse
`screenIndex`	`0`	`0`-`16`	Index de l’écran commençant à zéro
`maxWidth`	`1440`	`480`-`3840`	Limite de taille de capture demandée ; macOS sans interface graphique l’applique à la plus grande dimension
`visionModel`	non défini	`provider/model`	Route structurée explicite ; les références mal formées suspendent l’analyse, les fournisseurs non pris en charge font échouer les lots
`retentionDays`	`14`	`1`-`365`	Supprime les anciennes images ; les cartes, les observations et les réunions quotidiennes sont conservées

Sans nodeId, Logbook privilégie un Node d’application connecté exposant screen.snapshot, puis se replie sur un Node sans interface graphique exposant logbook.snapshot. Dans une configuration non limitée à un Node, un Node défaillant passe derrière les autres Nodes admissibles. Le bouton de pause du tableau de bord s’applique uniquement à la session et se réinitialise au redémarrage du Gateway ; utilisez captureEnabled: false pour un arrêt persistant.

Sélection du modèle de vision

Logbook résout le modèle d’observation dans cet ordre :

plugins.entries.logbook.config.visionModel
la première entrée Codex compatible avec les images sous tools.media.image.models
la première entrée Codex compatible avec les images sous tools.media.models

Les autres fournisseurs multimédias sont ignorés, car ils n’exposent pas actuellement le contrat d’extraction structurée requis par Logbook. Définir tools.media.image.enabled: false désactive les valeurs multimédias par défaut empruntées, mais un visionModel explicite de Logbook continue de s’appliquer.

Onglet du tableau de bord

Chronologie : cartes extensibles par activité, avec couleurs de catégorie, application principale, étiquettes de distraction et image clé.
Vue d’ensemble de la journée : taux de concentration, répartition par catégorie, principales applications.
Réunion quotidienne : transforme les informations d’hier et d’aujourd’hui en compte rendu prêt à coller.
Interroger votre journée : questions en langage naturel auxquelles répond la chronologie suivie (« quand ai-je examiné la PR du Gateway ? »).
Analyser maintenant : ferme immédiatement la fenêtre de capture actuelle au lieu d’attendre l’intervalle d’analyse.

Méthodes du Gateway

Logbook enregistre les méthodes RPC du Gateway suivantes :

Méthode	Paramètres	Portée	Résultat
`logbook.status`	aucun	`operator.read`	État de la capture, de l’analyse, du modèle, du Node, du jour et du fuseau horaire du Gateway
`logbook.days`	aucun	`operator.read`	Jours avec nombre de cartes chronologiques et limites temporelles des cartes
`logbook.timeline`	`{ day?: "YYYY-MM-DD" }`	`operator.read`	Cartes dérivées et statistiques de la journée ; utilise par défaut le jour actuel du Gateway
`logbook.frames`	`{ startMs, endMs }`	`operator.write`	Métadonnées des images dans la plage demandée, exprimée en millisecondes depuis l’époque
`logbook.frame`	`{ frameId }`	`operator.write`	Une image JPEG brute encodée en base64
`logbook.standup`	`{ day?, refresh? }`	`operator.write`	Texte de réunion quotidienne mis en cache ou régénéré pour une journée
`logbook.ask`	`{ day?, question }`	`operator.write`	Réponse fondée sur la chronologie pour une journée
`logbook.capture.set`	`{ paused }`	`operator.write`	État de pause limité à la session et statut mis à jour
`logbook.analyze.now`	aucun	`operator.write`	Lance l’analyse en attente ou renvoie la raison pour laquelle elle n’a pas pu démarrer

Les méthodes de lecture renvoient l’état opérationnel ou du texte dérivé. Les pixels des captures d’écran brutes, les actions entraînant des dépenses de modèle et les mutations de l’environnement d’exécution nécessitent operator.write. L’onglet Control UI nécessite également operator.write, car il expose ces actions et les aperçus d’images brutes ; un client en lecture seule peut toujours appeler directement les méthodes de texte dérivé.

Remarques sur la confidentialité

Les instantanés peuvent contenir tout ce qui s’affiche à l’écran, y compris des secrets. Les images ne quittent jamais la machine, sauf comme entrée échantillonnée envoyée au modèle d’observation configuré.
Les observations, les cartes récentes et les questions peuvent quitter la machine via le modèle d’agent par défaut lors de la synthèse des cartes, de la génération de la réunion quotidienne ou des questions-réponses. Appliquez la politique de traitement des données du fournisseur aux deux routes de modèles.
Utilisez des routes locales pour le modèle d’observation structurée et le modèle d’agent par défaut lorsque vous avez besoin d’un pipeline entièrement local.
Les images, la base de données de la chronologie et les captures temporaires sont écrites avec des autorisations de fichier réservées au propriétaire.
L’ajout de screen.snapshot à gateway.nodes.denyCommands constitue le coupe-circuit de la capture d’écran : il bloque à la fois la capture par les Nodes d’application et la commande logbook.snapshot propre à Logbook.
Définir tools.media.image.enabled: false empêche également Logbook d’emprunter les modèles d’image multimédia pour l’analyse ; seul un visionModel explicite dans la configuration du plugin est alors utilisé.

Dépannage

L’onglet Logbook est absent

Vérifiez les trois conditions suivantes :

openclaw plugins list --enabled inclut logbook.
Le Gateway a redémarré après la modification du plugin ou de la liste d’autorisation.
La connexion Control UI dispose de operator.write ; les sessions en lecture seule ne reçoivent pas le descripteur d’onglet interactif.

Si plugins.allow est défini, il doit inclure à la fois logbook et codex pour la configuration recommandée.

La capture signale une erreur

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

Vérifiez que le Node expose screen.snapshot ou logbook.snapshot.
Accordez l’autorisation d’enregistrement de l’écran sur le Mac de capture.
Si nodeId est configuré, vérifiez qu’il correspond à l’identifiant ou au nom d’affichage du Node.
Vérifiez que gateway.nodes.denyCommands ne contient pas screen.snapshot.

Après trois échecs consécutifs, Logbook suspend les tentatives pendant dix cycles de capture, puis réessaie. Une configuration non épinglée peut basculer vers un autre Node éligible.

Les captures réussissent, mais aucune carte n’apparaît

Un état Modèle manquant signifie qu’aucune voie de vision structurée compatible n’a été trouvée. Activez et authentifiez le Plugin Codex, ou définissez un visionModel explicite valide. Les images capturées restent en attente tant que le modèle est manquant et peuvent être analysées une fois la configuration corrigée.
Attendez la durée définie par analysisIntervalMinutes, ou sélectionnez Analyser maintenant après la capture d’une activité.
Les images identiques consécutives constituent des indices d’inactivité et ne sont pas intégrées aux lots d’analyse. Modifiez le contenu visible à l’écran avant de tester.
Si le dernier lot affiche une erreur, corrigez le problème de modèle ou d’authentification, puis sélectionnez Analyser maintenant. Les lots en échec ne sont relancés que par cette action explicite afin d’éviter des dépenses répétées liées au modèle.

Overview

Plugins

Plugin guides

Building plugins

Skills

Automation

Tools

Agent coordination

Plugin de journal de bord

Avant de commencer

Démarrage rapide

Fonctionnement

Modèles et flux de données

Configuration

Sélection du modèle de vision

Onglet du tableau de bord

Méthodes du Gateway

Remarques sur la confidentialité

Dépannage

L’onglet Logbook est absent

La capture signale une erreur

Les captures réussissent, mais aucune carte n’apparaît

Pages connexes

​Avant de commencer

​Démarrage rapide

​Fonctionnement

​Modèles et flux de données

​Configuration

​Sélection du modèle de vision

​Onglet du tableau de bord

​Méthodes du Gateway

​Remarques sur la confidentialité

​Dépannage

​L’onglet Logbook est absent

​La capture signale une erreur

​Les captures réussissent, mais aucune carte n’apparaît

​Pages connexes

Avant de commencer

Démarrage rapide

Fonctionnement

Modèles et flux de données

Configuration

Sélection du modèle de vision

Onglet du tableau de bord

Méthodes du Gateway

Remarques sur la confidentialité

Dépannage

L’onglet Logbook est absent

La capture signale une erreur

Les captures réussissent, mais aucune carte n’apparaît

Pages connexes