SuperAPI AI 工具集

session-logs

通用与其它

查看项目

更新于 10-16 06:37

技能介绍

用途

session-logs 用于检索存储在 session JSONL 文件中的完整对话历史。当用户引用较早或父级对话,或询问之前说过什么、需要记忆中不存在的历史上下文时,可以使用该技能查找并分析会话日志。

主要能力

该技能围绕 jq 提供对会话日志的查询能力,可完成以下常见操作:

  • 按日期和大小列出全部会话
  • 查找特定日期的会话
  • 从某个会话中提取用户消息
  • 在助手回复中按关键词搜索
  • 计算单个会话的总费用
  • 生成每日费用汇总
  • 统计某个会话的消息数量与 token 数
  • 统计工具使用分布
  • 在全部会话中搜索某个短语

使用方式

会话日志存储位置为:~/.openclaw/agents/<agentId>/sessions/(使用系统提示 Runtime 行中的 agent=<id> 值)。

目录中包含:

  • sessions.json:会话键到会话 ID 的索引映射
  • <session-id>.jsonl:每个会话的完整对话转录

每条 .jsonl 文件中的消息包含以下字段:

  • type:"session"(元数据)或 "message"
  • timestamp:ISO 时间戳
  • message.role:"user"、"assistant" 或 "toolResult"
  • message.content[]:文本、思考或工具调用(过滤 type=="text" 可获得人类可读内容)
  • message.usage.cost.total:每条回复的费用

常见查询示例:

按日期和大小列出全部会话:

for f in ~/.openclaw/agents/<agentId>/sessions/*.jsonl; do
  date=$(head -1 "$f" | jq -r '.timestamp' | cut -dT -f1)
  size=$(ls -lh "$f" | awk '{print $5}')
  echo "$date $size $(basename $f)"
done | sort -r

查找特定日期的会话:

for f in ~/.openclaw/agents/<agentId>/sessions/*.jsonl; do
  head -1 "$f" | jq -r '.timestamp' | grep -q "2026-01-06" && echo "$f"
done

从会话中提取用户消息:

jq -r 'select(.message.role == "user") | .message.content[]? | select(.type == "text") | .text' <session>.jsonl

在助手回复中搜索关键词:

jq -r 'select(.message.role == "assistant") | .message.content[]? | select(.type == "text") | .text' <session>.jsonl | rg -i "keyword"

获取单个会话的总费用:

jq -s '[.[] | .message.usage.cost.total // 0] | add' <session>.jsonl

每日费用汇总:

for f in ~/.openclaw/agents/<agentId>/sessions/*.jsonl; do
  date=$(head -1 "$f" | jq -r '.timestamp' | cut -dT -f1)
  cost=$(jq -s '[.[] | .message.usage.cost.total // 0] | add' "$f")
  echo "$date $cost"
done | awk '{a[$1]+=$2} END {for(d in a) print d, "$"a[d]}' | sort -r

统计会话中的消息数与 token 数:

jq -s '{
  messages: length,
  user: [.[] | select(.message.role == "user")] | length,
  assistant: [.[] | select(.message.role == "assistant")] | length,
  first: .[0].timestamp,
  last: .[-1].timestamp
}' <session>.jsonl

工具使用分布:

jq -r '.message.content[]? | select(.type == "toolCall") | .name' <session>.jsonl | sort | uniq -c | sort -rn

在全部会话中搜索某个短语:

rg -l "phrase" ~/.openclaw/agents/<agentId>/sessions/*.jsonl

快速仅文本提示(低噪声):

jq -r 'select(.type=="message") | .message.content[]? | select(.type=="text") | .text' ~/.openclaw/agents/<agentId>/sessions/<id>.jsonl | rg 'keyword'

适用场景

  • 用户提到以前或父级的对话,需要回溯当时的对话内容
  • 需要查找记忆中不存在的历史上下文
  • 需要统计会话费用、消息数量、token 数或工具调用情况
  • 需要跨多个会话按短语检索

限制

  • 会话为仅追加的 JSONL 格式(每行一个 JSON 对象)
  • 大型会话可能有数 MB,建议使用 head/tail 进行采样
  • sessions.json 索引将聊天提供方(discord、whatsapp 等)映射到会话 ID
  • 已删除的会话带有 .deleted.<timestamp> 后缀
  • 其他功能、收费、价格或平台信息暂未提供