ログブック Plugin

​

はじめる前に

• screen.snapshot または logbook.snapshot を公開する、接続済みの Node。 macOS アプリの Node には画面収録の権限が必要です。ヘッドレス macOS Node ホスト (openclaw node host run) では、システムの screencapture ツールを使用する、 Plugin 提供の logbook.snapshot コマンドを利用できます。
• バンドルされた Codex Plugin が有効化および認証されていること。現在 Codex は、 Logbook に必要な構造化画像抽出コントラクトを提供します。 openclaw models auth login --provider openai でサインインしてください。その他の認証方法については、 Codex ハーネス を参照してください。
• 動作するデフォルトのエージェントモデル。Logbook はビジョン処理後に、カード、 スタンドアップノート、日単位の Q&A を合成するためにこのモデルを使用します。

​

クイックスタート

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 分）が経過すると、 Plugin は最大 16 個のアクティブなフレームをサンプリングしてビジョンモデルに送信し、 モデルはタイムスタンプ付きのアクティビティ観察結果（「VS Code: store.ts を編集し、 型エラーを修正」）を返します。2 分を超えるキャプチャの中断、またはローカルの午前 0 時でも、 現在のウィンドウが終了します。
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. tools.media.models 配下にある、画像対応の最初の Codex エントリ

​

ダッシュボードタブ

• タイムライン: カテゴリの色、メインアプリ、気の散りを示すチップ、 スナップショットのキーフレームを備えた、アクティビティごとの展開可能なカード。
• 一日の概要: 集中時間の比率、カテゴリの内訳、よく使用したアプリ。
• 日次スタンドアップ: 昨日と今日の情報を、すぐに貼り付けられる更新内容に変換します。
• その日について質問: 記録されたタイムラインに基づいて自然言語の質問に回答します （「Gateway の PR をレビューしたのはいつですか？」）。
• 今すぐ分析: 分析間隔を待たず、現在のキャプチャウィンドウをただちに終了します。

​

Gateway メソッド

​

プライバシーに関する注意事項

• スナップショットには、シークレットを含め、画面上のあらゆるものが含まれる可能性があります。フレームがマシンの外部に送信されるのは、設定された観測モデルへのサンプリング入力として使用される場合に限られます。
• 観測、最近のカード、質問は、カードの合成、スタンドアップの生成、Q&A の際に、デフォルトのエージェントモデルを通じてマシンの外部に送信される場合があります。両方のモデルルートにプロバイダーのデータ処理ポリシーを適用してください。
• 完全にローカルなパイプラインが必要な場合は、構造化観測モデルとデフォルトのエージェントモデルの両方にローカルルートを使用してください。
• フレーム、タイムラインデータベース、一時キャプチャは、所有者のみがアクセスできるファイル権限で書き込まれます。
• screen.snapshot を gateway.nodes.commands.deny に追加すると、画面キャプチャのキルスイッチとして機能し、アプリ Node のキャプチャと Logbook 自体の logbook.snapshot コマンドの両方をブロックします。
• tools.media.image.enabled: false を設定すると、Logbook が分析にメディア画像モデルを借用することも停止します。この場合、Plugin 設定で明示的に指定された visionModel のみが使用されます。

​

トラブルシューティング

​

Logbook タブが表示されない

1. openclaw plugins list --enabled に logbook が含まれている。
2. Plugin または許可リストを変更した後に Gateway が再起動されている。
3. Control UI 接続に operator.write がある。読み取り専用セッションにはインタラクティブなタブ記述子は送信されません。

​

キャプチャでエラーが報告される

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

• Node が screen.snapshot または logbook.snapshot を公開していることを確認してください。
• キャプチャを行う Mac で Screen Recording 権限を付与してください。
• nodeId が設定されている場合、Node ID または表示名と一致することを確認してください。
• gateway.nodes.commands.deny に screen.snapshot が含まれていないことを確認してください。

​

キャプチャは成功するがカードが表示されない

• モデルがありませんというステータスは、互換性のある構造化ビジョンルートが見つからなかったことを意味します。Codex Plugin を有効化して認証するか、有効な visionModel を明示的に設定してください。モデルがない間、キャプチャされたフレームは保留状態のままになり、設定を修正した後に分析できます。
• analysisIntervalMinutes を待つか、アクティビティがキャプチャされた後に 今すぐ分析 を選択してください。
• 連続する同一フレームはアイドル状態の証拠と見なされ、分析バッチには入りません。テストする前に、表示されている画面を変更してください。
• 最新のバッチにエラーが表示されている場合は、モデルまたは認証の問題を修正して 今すぐ分析 を選択してください。モデルの使用料金が繰り返し発生するのを避けるため、失敗したバッチはこの明示的な操作を行った場合にのみ再試行されます。

​

関連項目

• Plugin を管理する
• Codex ハーネス
• メディア理解
• Node
• Node のトラブルシューティング
• Control UI