ClawHub

Session回溯

Other

基于 OpenClaw 会话历史提取关键信息、查询关键词上下文，管理和回溯对话内容以辅助记忆和跟进。

Install

openclaw skills install session-recall

Session 回溯技能

概述

Session 回溯技能，用于从 OpenClaw 的会话历史中提取信息、管理记忆和回溯对话。

功能

1. 提取关键信息写入 memory/YYYY-MM-DD.md

将 session 中的关键信息提取并保存到记忆文件中。

使用方式：

  • 调用 write 工具将内容写入 memory/YYYY-MM-DD.md 文件
  • 日期格式：当天日期，如 memory/2026-03-05.md

提取内容建议：

  • 对话中的重要决策
  • 关键信息点
  • 待办事项
  • 学习到的关于主人的信息

示例：

# 2026-03-05 记忆

## 重要信息
- 主人想要了解如何回溯 session
- 主人让我发布了一个飞书文档技能到 ClawHub

## 待办
- [ ] 创建 session 回溯 skill

## 对话摘要
今天主人问了关于 session 的问题...

2. 查询关键词在 session 中的出现次数/上下文

工具：

  • 使用 sessions_list 工具列出所有 session
  • 使用 sessions_history 工具获取特定 session 的历史
  • 使用 read 工具直接读取 JSONL 文件

方法：

方法一：使用 sessions_list

# 列出最近所有 session
sessions_list

方法二：使用 sessions_history

# 获取特定 session 的历史
sessions_history --sessionKey "agent:lin_xiaoman:feishu:direct:ou_xxx"

方法三：直接读取 JSONL 文件

# 读取 session 文件
# 路径格式：~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl

# 示例：查找关键词 "外卖"
# 使用 read 工具读取文件，然后分析内容

查找关键词的上下文：

  1. 使用 sessions_list 获取所有 session 的基本信息
  2. 根据 sessionKey 确定目标 session
  3. 使用 sessions_history 获取完整历史
  4. 在内容中搜索关键词并记录上下文

3. 回溯某段 session 并添加到当前对话

方式一：使用 sessions_history 工具

  1. 找到目标 session 的 sessionKey
  2. 使用 sessions_history 获取历史
  3. 将需要回溯的内容通过对话方式告诉模型

方式二：直接读取 JSONL 文件

  1. 确定 sessionId（可以从 sessions.json 或 sessions_list 获取）
  2. 读取 JSONL 文件： 
    ~/.openclaw/agents/lin_xiaoman/sessions/<sessionId>.jsonl
  3. 提取需要的对话片段
  4. 将内容告诉用户或添加到当前上下文

重要提示：

  • 当前 session 的 sessionKey 格式：agent:lin_xiaoman:feishu:direct:ou_2545d3b430b99a135bdab87d5a09b68a
  • 当前 session 的 sessionId：3fefc0bb-b7e9-4736-b374-d1be9d12caec
  • JSONL 文件路径：~/.openclaw/agents/lin_xiaoman/sessions/3fefc0bb-b7e9-4736-b374-d1be9d12caec.jsonl

Session 文件位置

  • 索引文件：~/.openclaw/agents/<agentId>/sessions/sessions.json
  • 对话记录：~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl
  • 被 reset 的记录：~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl.reset.<时间戳>
  • 被删除的记录：~/.openclaw/agents/<agentId>/sessions/<sessionId>.jsonl.deleted.<时间戳>

使用示例

示例 1：查找今天关于"外卖"的对话

  1. 列出所有 session：

    sessions_list

  2. 获取当前飞书会话的历史：

    sessions_history --sessionKey "agent:lin_xiaoman:feishu:direct:ou_2545d3b430b99a135bdab87d5a09b68a"

  3. 分析内容，找到关于"外卖"的对话

示例 2：保存今天的重要对话到记忆

将今天的对话摘要写入 memory/2026-03-05.md

示例 3：回溯之前的某个 session

  1. 列出所有 session：sessions_list
  2. 找到目标 session 的 sessionKey
  3. 使用 sessions_history 获取历史
  4. 将需要的片段告诉用户

注意事项

  • 使用完 sessions_history 后，需要在回复中告诉用户找到的内容
  • JSONL 文件可以直接用 read 工具读取
  • 被 reset 的 session 文件后缀包含 .reset.
  • 被删除的 session 文件后缀包含 .deleted.