ログブックPlugin

Logbook plugin は、画面上のアクティビティを自動作業日誌に変換します。ペアリング済み Node から定期的に画面スナップショットを取得し、タイムスタンプ付きの観察結果に要約して、Control UI にタイムラインカードを作成します。また、日次スタンドアップノートを生成し、追跡した日についての質問に回答することもできます。

OpenClaw が所有する状態は Gateway 上の <state-dir>/logbook/ に保持されますが、モデルによる処理が必ずしもローカルで行われるとは限りません。サンプリングされたスクリーンショットは設定済みのビジョンルートに送信され、観察結果とタイムラインテキストはデフォルトのエージェントモデルに送信されます。画面内容とそこから生成されたアクティビティテキストをマシン上に保持する必要がある場合は、両方の段階でローカルモデルルートを使用してください。

Logbook は同梱されていますが、デフォルトでは無効です。captureEnabled のデフォルトが true であるため、plugin を有効にすると Gateway で画面キャプチャが有効になります。

始める前に

次のものが必要です。

• 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 を生成するためにこれを使用します。

クイックスタート

Codex と Logbook の plugin を有効にします。

openclaw plugins enable codexopenclaw plugins enable logbook

起動時の動作を確定させるため、ビジョンモデルを明示的に設定します。

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

plugins.allow を使用する場合は、codex と logbook の両方を含めてください。plugin の設定を変更した後に Gateway を再起動し、登録内容を確認してダッシュボードを開きます。

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

Node の説明には screen.snapshot または logbook.snapshot が含まれている必要があります。ヘッドレス Node が logbook.snapshot を通知するのは、plugin が有効になった後だけです。コマンドがない場合は、Node のトラブルシューティングを参照してください。

Logbook タブは、plugin が有効で、Control UI セッションに operator.write がある場合にのみ表示されます。ステータス行にはエラーなしで キャプチャ中 と表示される必要があります。分析ウィンドウが閉じるとタイムラインカードが表示されます。また、アクティビティがキャプチャされた後で 今すぐ分析 を選択することもできます。

仕組み

1. キャプチャ：captureIntervalSeconds（デフォルトは30秒）ごとに、Logbook は選択された Node のキャプチャコマンドを呼び出し、縮小された JPEG フレームを保存します。連続する同一フレームはアイドルとしてマークされ、分析から除外されます。
2. 観察：分析ウィンドウ（デフォルトは15分）が経過すると、plugin は最大16枚のアクティブなフレームをサンプリングしてビジョンモデルに送信します。モデルはタイムスタンプ付きのアクティビティ観察結果（「VS Code：store.ts を編集し、型エラーを修正」）を返します。2分を超えるキャプチャの空白期間が発生した場合や、ローカル時刻で午前0時になった場合も、現在のウィンドウが閉じます。
3. 統合：観察結果と既存カードの直近45分間の内容を、タイトル、概要、カテゴリ、メインアプリ、短時間の気晴らしを含むタイムラインカード（各10～60分）に再構成します。
4. 削除：retentionDays（デフォルトは14）より古いフレームを削除します。カード、観察結果、キャッシュ済みスタンドアップは保持されます。

日の境界とタイムラインの時刻には、ブラウザのタイムゾーンではなく Gateway のローカルタイムゾーンが使用されます。フレームと SQLite タイムラインデータベースは <state-dir>/logbook/ 配下に保存されます。

モデルとデータの流れ

Logbook は2つの異なるモデルルートを使用します。

完全な SQLite データベースがいずれかのモデルに送信されることはありません。生のスクリーンショットは観察段階にのみ送信されます。カードの統合、スタンドアップ、Q&A には派生テキストが渡されます。

設定

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

Logbook のすべての設定キーは省略可能です。数値は整数に丸められ、サポート範囲内に制限されます。

nodeId がない場合、Logbook はまず screen.snapshot を公開する接続済みアプリ Node を優先し、次に logbook.snapshot を公開するヘッドレス Node を使用します。固定されていない構成では、失敗した Node は他の適格な Node より後に回されます。ダッシュボードの一時停止切り替えはセッション内でのみ有効であり、Gateway の再起動時にリセットされます。永続的に停止するには captureEnabled: false を使用してください。

ビジョンモデルの選択

Logbook は次の順序で観察モデルを解決します。

1. plugins.entries.logbook.config.visionModel
2. tools.media.image.models 配下で最初の画像対応 Codex エントリ
3. tools.media.models 配下で最初の画像対応 Codex エントリ

他のメディアプロバイダーは、現在 Logbook が必要とする構造化抽出コントラクトを公開していないため、スキップされます。tools.media.image.enabled: false を設定すると、借用されるメディアのデフォルトが無効になりますが、明示的な Logbook の visionModel は引き続き適用されます。

ダッシュボードタブ

• タイムライン：アクティビティごとの展開可能なカード。カテゴリ色、メインアプリ、気晴らしチップ、スナップショットのキーフレームを表示します。
• 1日の概要：集中率、カテゴリ別内訳、使用上位アプリ。
• 日次スタンドアップ：昨日と今日の内容を、すぐに貼り付けられる更新文に変換します。
• 1日について質問：追跡されたタイムラインに基づいて自然言語の質問に回答します（「Gateway の PR をレビューしたのはいつ？」）。
• 今すぐ分析：分析間隔を待たずに、現在のキャプチャウィンドウを直ちに閉じます。

Gateway メソッド

Logbook は次の Gateway RPC メソッドを登録します。

読み取りメソッドは、動作状態または派生テキストを返します。生のスクリーンショットのピクセル、モデルの利用料金が発生する操作、ランタイムの変更には operator.write が必要です。Control UI タブも、これらの操作と生フレームのプレビューを公開するため、operator.write が必要です。読み取り専用クライアントでも、派生テキストのメソッドを直接呼び出すことはできます。

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

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

トラブルシューティング

Logbook タブが表示されない

次の3つの条件をすべて確認してください。

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

plugins.allow が設定されている場合、推奨構成では logbook と codex の両方を含める必要があります。

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

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

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

3 回連続で失敗すると、Logbook はキャプチャの 10 ティック分バックオフしてから再試行します。固定されていない構成では、別の適格な Node に切り替わることがあります。

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

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

関連項目

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