Plugin de bitácora

El Plugin Logbook convierte la actividad de la pantalla en un diario de trabajo automático. Captura instantáneas periódicas de pantalla desde un nodo emparejado, las resume en observaciones con marca de tiempo y crea tarjetas de cronología en la interfaz de control.

También puede generar notas diarias de reunión y responder preguntas sobre un día registrado.

El estado propiedad de OpenClaw permanece en el Gateway bajo <state-dir>/logbook/, pero el procesamiento del modelo no necesariamente es local. Las capturas muestreadas se envían a la ruta de visión configurada; las observaciones y el texto de la cronología se envían al modelo de agente predeterminado. Usa rutas de modelo locales para ambas etapas si el contenido de pantalla y el texto de actividad derivado deben permanecer en la máquina.

Logbook viene incluido y está deshabilitado de forma predeterminada. Habilitar el Plugin hace que el Gateway permita la captura de pantalla porque captureEnabled tiene true como valor predeterminado.

Antes de empezar

Necesitas:

• Un nodo conectado que exponga screen.snapshot o logbook.snapshot. El nodo de la app de macOS necesita permiso de Grabación de pantalla. Un host de nodo macOS sin interfaz gráfica (openclaw node host run) obtiene el comando logbook.snapshot proporcionado por el Plugin, respaldado por la herramienta del sistema screencapture.
• El Plugin Codex incluido habilitado y autenticado. Codex actualmente proporciona el contrato de extracción estructurada de imágenes que Logbook requiere. Inicia sesión con openclaw models auth login --provider openai; consulta arnés de Codex para otras rutas de autenticación.
• Un modelo de agente predeterminado funcional. Logbook lo usa para sintetizar tarjetas, notas de reunión y preguntas y respuestas del día después de la pasada de visión.

Inicio rápido

Habilita los Plugins Codex y Logbook:

openclaw plugins enable codexopenclaw plugins enable logbook

Configura un modelo de visión explícito para un inicio determinista:

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

Si usas plugins.allow, incluye tanto codex como logbook. Reinicia el Gateway después de cambiar la configuración de Plugins; luego inspecciona los registros y abre el panel:

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

La descripción del nodo debe incluir screen.snapshot o logbook.snapshot. Los nodos sin interfaz gráfica anuncian logbook.snapshot solo después de que el Plugin esté activo. Consulta solución de problemas de nodos si falta el comando.

La pestaña Logbook aparece solo para un Plugin habilitado y una sesión de la interfaz de control con operator.write. La fila de estado debería mostrar Capturando sin errores. Aparece una tarjeta de cronología cuando se cierra la ventana de análisis, o puedes seleccionar Analizar ahora después de que se haya capturado actividad.

Cómo funciona

1. Captura: cada captureIntervalSeconds (30 s de forma predeterminada), Logbook invoca el comando de captura del nodo seleccionado y almacena un fotograma JPEG escalado. Los fotogramas consecutivos idénticos se marcan como inactivos y se excluyen del análisis.
2. Observación: una vez que transcurre una ventana de análisis (15 minutos de forma predeterminada), el Plugin muestrea hasta 16 fotogramas activos y los envía al modelo de visión, que devuelve observaciones de actividad con marca de tiempo ("VS Code: editando store.ts, corrigiendo un error de tipo"). Una brecha de captura superior a dos minutos o la medianoche local también cierra la ventana actual.
3. Síntesis: las observaciones más los últimos 45 minutos de tarjetas existentes se revisan para formar tarjetas de cronología (de 10 a 60 minutos cada una) con título, resumen, categoría, app principal y cualquier distracción breve.
4. Poda: se eliminan los fotogramas más antiguos que retentionDays (14 de forma predeterminada). Las tarjetas, observaciones y notas de reunión en caché se conservan.

Los límites del día y los relojes de la cronología usan la zona horaria local del Gateway, no la zona horaria del navegador. Los fotogramas y la base de datos SQLite de la cronología residen bajo <state-dir>/logbook/.

Modelo y flujo de datos

Logbook usa dos rutas de modelo separadas:

La base de datos SQLite completa no se envía a ningún modelo. Las capturas sin procesar van solo a la etapa de observación; la síntesis de tarjetas, la reunión y las preguntas y respuestas reciben texto derivado.

Configuración

{  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.5",          retentionDays: 14,        },      },    },  },}

Todas las claves de configuración de Logbook son opcionales. Los valores numéricos se redondean a enteros y se limitan al rango admitido.

Sin nodeId, Logbook prefiere un nodo de app conectado que exponga screen.snapshot, luego recurre a un nodo sin interfaz gráfica que exponga logbook.snapshot. En una configuración sin fijar, un nodo fallido rota detrás de otros nodos elegibles. El interruptor de pausa del panel es solo de sesión y se restablece cuando el Gateway se reinicia; usa captureEnabled: false para una detención persistente.

Selección del modelo de visión

Logbook resuelve el modelo de observación en este orden:

1. plugins.entries.logbook.config.visionModel
2. la primera entrada Codex con capacidad de imagen bajo tools.media.image.models
3. la primera entrada Codex con capacidad de imagen bajo tools.media.models

Otros proveedores de medios se omiten porque actualmente no exponen el contrato de extracción estructurada que Logbook requiere. Establecer tools.media.image.enabled: false deshabilita los valores predeterminados de medios prestados, pero un visionModel explícito de Logbook sigue aplicándose.

Pestaña del panel

• Cronología: tarjetas expandibles por actividad con colores de categoría, la app principal, etiquetas de distracción y un fotograma clave de instantánea.
• El día de un vistazo: proporción de foco, desglose por categoría, apps principales.
• Reunión diaria: convierte ayer y hoy en una actualización lista para pegar.
• Preguntar por tu día: preguntas en lenguaje natural respondidas a partir de la cronología registrada ("¿cuándo revisé el PR del gateway?").
• Analizar ahora: cierra la ventana de captura actual inmediatamente en lugar de esperar el intervalo de análisis.

Métodos del Gateway

Logbook registra estos métodos RPC del Gateway:

Los métodos de lectura devuelven estado operativo o texto derivado. Los píxeles de capturas sin procesar, las acciones con gasto de modelo y las mutaciones en runtime requieren operator.write. La pestaña de la interfaz de control también requiere operator.write porque expone esas acciones y vistas previas de fotogramas sin procesar; un cliente de solo lectura aún puede llamar directamente a los métodos de texto derivado.

Notas de privacidad

• Las instantáneas pueden contener cualquier cosa en pantalla, incluidos secretos. Los fotogramas nunca salen de la máquina excepto como entrada muestreada para el modelo de observación configurado.
• Las observaciones, tarjetas recientes y preguntas pueden salir de la máquina mediante el modelo de agente predeterminado durante la síntesis de tarjetas, la generación de reuniones o las preguntas y respuestas. Aplica la política de manejo de datos del proveedor a ambas rutas de modelo.
• Usa rutas locales tanto para el modelo de observación estructurada como para el modelo de agente predeterminado cuando necesites una canalización completamente local.
• Los fotogramas, la base de datos de cronología y las capturas temporales se escriben con permisos de archivo solo para el propietario.
• Agregar screen.snapshot a gateway.nodes.denyCommands es el interruptor de apagado de la captura de pantalla: bloquea tanto la captura del nodo de app como el propio comando logbook.snapshot de Logbook.
• Establecer tools.media.image.enabled: false también impide que Logbook tome prestados los modelos de imagen de medios para el análisis; entonces solo se usa un visionModel explícito en la configuración del Plugin.

Solución de problemas

Falta la pestaña Logbook

Revisa las tres condiciones:

1. openclaw plugins list --enabled incluye logbook.
2. El Gateway se reinició después del cambio del Plugin o de la lista de permitidos.
3. La conexión de la interfaz de control tiene operator.write; las sesiones de solo lectura no reciben el descriptor de pestaña interactiva.

Si plugins.allow está configurado, debe incluir tanto logbook como codex para la configuración recomendada.

La captura informa de un error

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

• Confirma que el nodo expone screen.snapshot o logbook.snapshot.
• Concede permiso de grabación de pantalla en el Mac de captura.
• Si nodeId está configurado, confirma que coincide con el id del nodo o el nombre para mostrar.
• Comprueba que gateway.nodes.denyCommands no contenga screen.snapshot.

Después de tres fallos consecutivos, Logbook espera diez ticks de captura y luego vuelve a intentarlo. Una configuración sin fijar puede rotar a otro nodo apto.

Las capturas se completan, pero no aparecen tarjetas

• Un estado Falta el modelo significa que no se encontró una ruta de visión estructurada compatible. Activa y autentica el plugin de Codex, o establece un visionModel explícito válido. Los fotogramas capturados permanecen pendientes mientras falta el modelo y pueden analizarse después de corregir la configuración.
• Espera a analysisIntervalMinutes, o selecciona Analizar ahora después de que se haya capturado actividad.
• Los fotogramas idénticos consecutivos son evidencia de inactividad y no entran en los lotes de análisis. Cambia la pantalla visible antes de probar.
• Si el lote más reciente muestra un error, corrige el problema del modelo o de autenticación y selecciona Analizar ahora. Los lotes fallidos se reintentan solo con esa acción explícita para evitar gasto repetido del modelo.

Relacionado

• Gestionar plugins
• Arnés de Codex
• Comprensión de medios
• Nodos
• Solución de problemas de nodos
• Interfaz de control