session-logs

搜索存储在 session JSONL 文件中的完整对话历史。当用户提及更早的/父级对话，或询问之前说过的内容时，请使用此功能。

触发条件

当用户询问先前的聊天记录、父级对话，或涉及不在 memory 文件中的历史上下文时，启用该技能。

存储位置

会话日志位于：~/.clawdbot/agents//sessions/（请使用系统提示中 Runtime 行的 agent= 值）。

• sessions.json —— 会话键（session key）到会话 ID 的索引映射文件
• .jsonl —— 每个会话的完整对话记录

文件结构

每个 .jsonl 文件包含如下字段的消息：

• type：值为 "session"（元数据）或 "message"
• timestamp：ISO 格式时间戳
• message.role：取值为 "user"、"assistant" 或 "toolResult"
• message.content[]：文本内容、思考过程或工具调用；如需提取人类可读内容，请筛选 type=="text" 的条目
• message.usage.cost.total：每次响应产生的费用

常用查询示例

按日期和大小列出所有会话

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

在助手回复中搜索关键词

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

获取单个会话的总费用

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

每日费用汇总

for f in ~/.clawdbot/agents//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
}' .jsonl

工具调用使用情况分析

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

跨所有会话搜索某短语

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

使用提示

• 会话日志采用仅追加（append-only）JSONL 格式（每行一个 JSON 对象）
• 大型会话文件可能达数 MB —— 可使用 head/tail 进行抽样查看
• sessions.json 索引文件将聊天平台（如 discord、whatsapp 等）映射至对应会话 ID
• 已删除的会话文件名带有 .deleted. 后缀

快速纯文本检索提示（低噪声）

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