SuperAPI AI 工具集

session-logs

通用与其它

查看项目

更新于 10-16 07:43

技能介绍

session-logs 是一个面向会话日志检索与分析的技能,核心用途是搜索存储在会话 JSONL 文件中的完整对话历史。当用户引用较早或父级对话、或询问此前说过什么时,可使用该技能。其触发条件为:用户询问此前聊天、父级对话,或需要查阅不在记忆文件中的历史上下文。

会话日志的位置为:~/.openclaw/agents/<agentId>/sessions/,其中 <agentId> 取自系统提示词 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 为每条响应的成本。

该技能提供以下常见查询能力。按日期和大小列出全部会话,可通过遍历 *.jsonl 文件、读取首行时间戳并获取文件大小实现。查找某一天的会话,可通过在首行时间戳中匹配指定日期(如 2026-01-06)实现。提取某个会话中的用户消息,可使用 jq 筛选 message.role == "user" 并选择文本内容。在助手回复中按关键词搜索,可在筛选 assistant 角色文本后配合 rg -i 进行。统计单个会话总成本,可对 message.usage.cost.total 求和。生成每日成本摘要,可按日期聚合各会话成本。统计会话中的消息与 token 数量,可汇总 length、user、assistant 数量以及首尾时间戳。工具使用情况拆分,可提取 type=="toolCall" 的 name 并统计排序。跨全部会话搜索短语,可用 rg -l 在会话目录中查找。此外还有一条低噪声的纯文本快速提示查询,用于筛选 message 类型的文本内容并配合 rg 搜索关键词。

使用提示方面:会话为追加式 JSONL,每行一个 JSON 对象;较大的会话可能有数 MB,可使用 head/tail 进行采样;sessions.json 索引将会话提供方(如 discord、whatsapp 等)映射到会话 ID;已删除的会话带有 .deleted.<timestamp> 后缀。

关于限制与定价:除上述基于 message.usage.cost.total 的成本读取能力外,资料未提供该技能自身的收费、价格或平台支持信息。