什么是Openclaw History Viewer
OpenClaw History Viewer 是一款专为 OpenClaw 聊天机器人设计的本地 Web 服务工具，用于浏览、查看和管理历史聊天记录。该工具通过启动一个轻量级 HTTP 服务器，让用户能够直观地访问和操作保存在本地的会话数据，无需依赖复杂的数据库或第三方平台。其核心优势在于支持自动会话备份机制，即使 OpenClaw 在创建新会话时会覆盖原有 `sessions.json` 文件，也能通过读取 `.reset.` 后缀的备份文件完整保留历史对话，彻底解决用户“旧记录丢失”的痛点。 该工具提供了现代化的双重视图界面：列表视图以紧凑卡片形式展示所有会话，包含会话 ID、消息数量、频道类型（如 webchat、discord、telegram）及最后更新时间；而聊天视图则采用类微信/ Telegram 的对话布局，用户消息居右（紫色气泡），助手消息居左（灰色气泡），系统消息居中显示，并支持折叠展开思考过程与工具调用详情。此外，所有页面均统一使用💬对话气泡作为浏览器标签页图标，提升视觉识别度。 除了图形界面，OpenClaw History Viewer 还提供完整的 JSON API 接口，支持通过 RESTful 方式获取会话列表和详细内容。开发者可通过 `GET /api/sessions` 获取带时间戳和统计信息的会话元数据，也可用 `GET /api/session?id=` 导出特定会话的完整消息流，每条消息按 JSONL 格式存储，涵盖 session、message、toolCall、thinking_level_change 等多种类型。整个系统基于 Python 实现，默认监听 localhost:8765，确保安全隔离于本地环境。
核心功能特点
- 支持自动会话备份，读取 OpenClaw 生成的 .reset. 文件防止历史记录丢失
- 提供现代化聊天视图与原始 Raw 视图切换，适配不同阅读习惯
- 内置刷新功能，保持当前阅读位置并实时同步最新数据
- 支持 JSON API 导出，便于脚本化获取或备份特定会话内容
- 响应式设计，兼容桌面端与移动端浏览器访问
适用场景
当用户需要回顾过往与 OpenClaw 的对话内容时，可直接通过自然语言指令如“启动历史记录查看器”或“打开聊天记录”触发该技能，系统将自动启动本地 Web 服务。例如，在完成一次复杂任务后，用户可能希望检查之前的工具调用结果或模型切换记录，此时只需在浏览器中访问 http://localhost:8765 即可进入聊天视图，点击任意会话查看完整交互流程，包括思考过程、工具执行日志等细节信息。 对于开发者和高级用户，该工具尤其适合批量处理历史数据。例如，可以通过 curl 命令调用 `/api/sessions` 接口获取所有会话的摘要信息，再结合 jq 工具进行筛选分析；也可以导出特定会话为 JSON 文件，用于后续调试、训练数据整理或迁移到其他系统。若用户担心 OpenClaw 的新会话操作会覆盖重要记录，还可手动运行备份脚本将当前会话保存至独立目录，实现双重保障。整个流程完全本地化，不依赖网络连接，保障隐私安全的同时兼顾灵活性与可扩展性。