Плагин журнала учета

​

Перед началом работы

• Подключённый Node, предоставляющий screen.snapshot или logbook.snapshot. Для Node приложения macOS требуется разрешение Screen Recording. На узле macOS без графического интерфейса (openclaw node host run) становится доступна предоставляемая плагином команда logbook.snapshot, использующая системный инструмент screencapture.
• Включённый и аутентифицированный встроенный плагин Codex. В настоящее время Codex предоставляет контракт структурированного извлечения данных из изображений, необходимый Logbook. Выполните вход с помощью openclaw models auth login --provider openai; другие способы аутентификации описаны в разделе Среда выполнения Codex.
• Рабочая модель агента по умолчанию. Logbook использует её после обработки моделью компьютерного зрения для создания карточек, заметок для стендапа и ответов на вопросы о дне.

​

Быстрый старт

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

​

Принцип работы

1. Захват: каждые captureIntervalSeconds (по умолчанию 30 с) Logbook вызывает команду захвата выбранного Node и сохраняет масштабированный кадр JPEG. Последовательные идентичные кадры помечаются как неактивные и исключаются из анализа.
2. Наблюдение: по истечении окна анализа (по умолчанию 15 минут) плагин выбирает до 16 активных кадров и отправляет их модели компьютерного зрения, которая возвращает наблюдения за активностью с временными метками («VS Code: редактирование store.ts, исправление ошибки типа»). Перерыв в захвате длительностью более двух минут или наступление местной полуночи также закрывает текущее окно.
3. Синтез: наблюдения вместе с существующими карточками за последние 45 минут преобразуются в обновлённые карточки хронологии (каждая длительностью 10–60 минут) с заголовком, сводкой, категорией, основным приложением и краткими отвлечениями.
4. Очистка: кадры старше retentionDays (по умолчанию 14) удаляются. Карточки, наблюдения и кэшированные стендапы сохраняются.

​

Модели и поток данных

​

Конфигурация

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

​

Выбор модели компьютерного зрения

1. plugins.entries.logbook.config.visionModel
2. первая запись Codex с поддержкой изображений в tools.media.image.models
3. первая запись Codex с поддержкой изображений в tools.media.models

​

Вкладка панели управления

• Хронология: разворачиваемые карточки для каждого вида активности с цветами категорий, основным приложением, метками отвлечений и ключевым снимком.
• Обзор дня: доля сосредоточенной работы, распределение по категориям, основные приложения.
• Ежедневный стендап: преобразует данные за вчера и сегодня в готовое для вставки обновление.
• Вопросы о дне: ответы на вопросы на естественном языке на основе отслеживаемой хронологии («когда я проверял PR для gateway?»).
• Анализировать сейчас: немедленно закрывает текущее окно захвата вместо ожидания интервала анализа.

​

Методы Gateway

​

Примечания о конфиденциальности

• Снимки могут содержать всё, что отображается на экране, включая секреты. Кадры никогда не покидают компьютер, кроме случаев, когда они передаются в качестве выборочных входных данных настроенной модели наблюдения.
• Наблюдения, недавние карточки и вопросы могут покидать компьютер через модель агента по умолчанию во время синтеза карточек, формирования сводки или ответов на вопросы. Применяйте политику обработки данных провайдера к обоим маршрутам моделей.
• Используйте локальные маршруты как для структурированной модели наблюдения, так и для модели агента по умолчанию, если требуется полностью локальный конвейер.
• Кадры, база данных временной шкалы и временные снимки записываются с правами доступа только для владельца.
• Добавление screen.snapshot в gateway.nodes.denyCommands служит аварийным выключателем захвата экрана: оно блокирует как захват узлом приложения, так и собственную команду logbook.snapshot Logbook.
• Установка tools.media.image.enabled: false также запрещает Logbook использовать модели изображений для анализа медиаданных; в этом случае используется только явно заданный visionModel в конфигурации плагина.

​

Устранение неполадок

​

Вкладка Logbook отсутствует

1. openclaw plugins list --enabled содержит logbook.
2. Gateway был перезапущен после изменения плагина или списка разрешений.
3. Подключение Control UI имеет operator.write; сеансы только для чтения не получают дескриптор интерактивной вкладки.

​

При захвате возникает ошибка

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

• Убедитесь, что узел предоставляет screen.snapshot или logbook.snapshot.
• Предоставьте разрешение Screen Recording на компьютере Mac, выполняющем захват.
• Если настроен nodeId, убедитесь, что он совпадает с идентификатором или отображаемым именем узла.
• Убедитесь, что gateway.nodes.denyCommands не содержит screen.snapshot.

​

Захват выполняется успешно, но карточки не появляются

• Статус Модель отсутствует означает, что совместимый маршрут структурированной модели компьютерного зрения не найден. Включите и аутентифицируйте плагин Codex либо задайте допустимый явный visionModel. Пока модель отсутствует, захваченные кадры остаются в ожидании и могут быть проанализированы после исправления конфигурации.
• Дождитесь analysisIntervalMinutes или выберите Анализировать сейчас после того, как активность будет зафиксирована.
• Последовательные одинаковые кадры считаются признаком бездействия и не включаются в пакеты анализа. Перед тестированием измените видимое содержимое экрана.
• Если последний пакет содержит ошибку, устраните проблему с моделью или аутентификацией и выберите Анализировать сейчас. Неудачные пакеты повторно обрабатываются только после этого явного действия, чтобы избежать повторных расходов на модель.

​

Связанные материалы

• Управление плагинами
• Среда Codex
• Анализ медиаданных
• Узлы
• Устранение неполадок узлов
• Control UI