SuperAPI AI 工具集

session-logs

通用与其它

查看项目

更新于 10-16 09:35

技能介绍

用途:当用户询问此前的聊天、父级对话或内存文件中没有的历史上下文时,用此技能搜索并分析完整的会话历史记录。会话日志位于活动状态目录:$OPENCLAW_STATE_DIR/agents/<agentId>/sessions/(默认 ~/.openclaw/agents/<agentId>/sessions/),其中 sessions.json 是会话键到会话 ID 的索引,<session-id>.jsonl 是每个会话的完整对话记录。每条 .jsonl 记录含 type(session 元数据或 message)、timestamp、message.role(user、assistant、toolResult)、message.content[](文本、思考或工具调用,过滤 type=="text" 可得可读内容)以及 message.usage.cost.total(每次响应成本)。

主要能力与用法:可通过 jq 与 shell 组合实现按日期和大小列出会话、查找特定日期的会话、提取用户消息、按关键词搜索助手回复、统计会话总成本、生成每日成本汇总、统计消息与 token 数、分析工具使用分布,以及跨所有会话搜索短语。 例如提取用户消息: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。

适用场景:需要回溯早期对话、核对历史内容、审计消息与工具调用、统计 token 与费用,或检索跨会话出现过的短语。

限制与提示:会话为仅追加的 JSONL(每行一个 JSON 对象),大文件可达数 MB,可用 head/tail 采样;sessions.json 索引将聊天来源(discord、whatsapp 等)映射到会话 ID;已删除会话带有 .deleted.<timestamp> 后缀。官方收录说明未提供其他平台、收费或限制信息。