日志簿（Logbook）屏幕活动自动沉淀为结构化的时间线、站会记录和可问答的工作日记。
文章目录
- 概览
- 前提条件
- Ubuntu 24.04 配置
- 🖥️ 安装屏幕捕获工具
- 📦 配置节点命令
- 🔐 权限与桌面环境
- 📁 状态目录
- 快速开始
- 1️⃣ 启用插件
- 2️⃣ 配置显式视觉模型（推荐）
- 3️⃣ 重启并验证
- 4️⃣ 开始捕获
- 工作原理与数据流
- 模型路由详解
- 配置参数全解
- 仪表板功能
- Gateway RPC 方法
- 隐私与安全
- 故障排查
- ❌ Logbook 选项卡不显示
- ❌ 捕获报告错误
- ❌ 捕获成功但无卡片生成
概览
Logbook 是 OpenClaw 的内置插件，提供以下核心能力：
- 自动捕获：定期从已配对的节点抓取屏幕快照（缩放为 JPEG）。
- 智能观察：通过视觉模型将连续帧总结为带时间戳的活动描述（例如“VS Code：正在编辑 store.ts，修复类型错误”）。
- 一键站会：基于昨日/今日活动生成站会更新文本。
- 时间线问答：用自然语言询问某天的活动（如“我什么时候审查过 PR？”）。
所有状态保存在 Gateway 的<state-dir>/logbook/目录下（SQLite 数据库 + 帧文件），模型处理可在本地或云端进行。
前提条件
在 Ubuntu 24.04 上使用 Logbook 前，请确保满足以下条件：
| 条件 | 说明 |
|---|---|
| ✅已连接节点 | 节点必须公开screen.snapshot或logbook.snapshot能力。•macOS 应用节点 |
