SSkills导航
首页/Skills/会话日志搜索与分析
数据分析中等风险

会话日志搜索与分析

使用 jq 和 ripgrep 搜索并分析本地存储的会话 JSONL 日志文件，快速定位历史对话与使用统计。

by @skillhubv1.0.06 浏览3 下载
#jq#JSONL#ripgrep#会话记录#命令行#成本统计#日志分析
推荐方式

直接交给 AI

无需安装文件。复制一句话，让 AI 在线读取这个 Skill。

下载 Skill ZIP ↓ 查看 SKILL.md 原文 ↗
01

它能帮你做什么

先看懂，再决定要不要交给 AI。

该 Skill 用于在本地会话日志目录（~/.clawdbot/agents/<agentId>/sessions/）中搜索与分析历史对话记录。会话以 JSONL 格式存储，每个文件包含消息类型、时间戳、角色（user/assistant/toolResult）以及内容。Skill 提供常见的 jq 与 rg 查询模板，包括按日期列出所有会话、提取特定会话的用户或助手消息、跨会话搜索关键词、统计会话成本、按日汇总花费、统计消息与 token 数量、工具调用分布等。适合需要回溯历史上下文、进行成本分析或审计工具使用情况的场景。

✓查找旧会话或父会话中的历史对话内容
✓按日期列出所有会话及其大小
✓跨多个会话文件搜索特定关键词
✓提取某个会话的全部用户或助手文本消息
✓统计单个会话的 token 与花费
✓按天汇总所有会话的总成本
✓统计会话中各类工具调用的频次
✓快速过滤低噪声的纯文本内容进行关键字搜索
02

怎么交给 AI

在线读取优先，本地安装作为备选。

◎
在线读取推荐 · 不需要安装

适合能访问网页的 ChatGPT、Agent 或其他 AI。

AI Prompt请访问 https://skills.dhmip.cn/skills/skillhub/session-logs/SKILL.md，读取并按照该 Skill 完成任务；如当前环境支持本地安装，也可以下载该 Skill。
↓
下载安装到 Agent适合支持 Skills 的客户端

未登录时可使用公共安装文档；登录后可以按不同 AI 分开管理。

Install Prompt请根据 https://skills.dhmip.cn/install/skillhub.md，安装 @skillhub/session-logs。
登录后管理多个 AI →
03

兼容性与要求

安装或使用前，先确认环境是否匹配。

适用客户端

Claude Code其他支持 shell 调用的 Agent 客户端

使用要求

  • 本地已安装 jq
  • 本地已安装 ripgrep (rg)
  • 能够访问 ~/.clawdbot/agents/<agentId>/sessions/ 目录
  • 运行在类 Unix shell 环境（bash）
⌘技术详情查看完整 SKILL.md 与原始内容
⌄
SKILL.mdRaw ↗

name: session-logs
description: Search and analyze your own session logs (older/parent conversations) using jq.
metadata: {"openclaw":{"emoji":"📜","requires":{"bins":["jq","rg"]}}}

session-logs

Search your complete conversation history stored in session JSONL files. Use this when a user references older/parent conversations or asks what was said before.

Trigger

Use this skill when the user asks about prior chats, parent conversations, or historical context that isn’t in memory files.

Location

Session logs live at: ~/.clawdbot/agents/<agentId>/sessions/ (use the agent=<id> value from the system prompt Runtime line).

  • sessions.json - Index mapping session keys to session IDs
  • <session-id>.jsonl - Full conversation transcript per session

Structure

Each .jsonl file contains messages with:

  • type: "session" (metadata) or "message"
  • timestamp: ISO timestamp
  • message.role: "user", "assistant", or "toolResult"
  • message.content[]: Text, thinking, or tool calls (filter type=="text" for human-readable content)
  • message.usage.cost.total: Cost per response

Common Queries

List all sessions by date and size

for f in ~/.clawdbot/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

Find sessions from a specific day

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

Extract user messages from a session

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

Search for keyword in assistant responses

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

Get total cost for a session

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

Daily cost summary

for f in ~/.clawdbot/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

Count messages and tokens in a session

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

Tool usage breakdown

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

Search across ALL sessions for a phrase

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

Tips

  • Sessions are append-only JSONL (one JSON object per line)
  • Large sessions can be several MB - use head/tail for sampling
  • The sessions.json index maps chat providers (discord, whatsapp, etc.) to session IDs
  • Deleted sessions have .deleted.<timestamp> suffix

Fast text-only hint (low noise)

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