SuperAPI AI 工具集

session-logs

通用与其它

查看项目

更新于 10-15 20:21

技能介绍

用途:当用户询问此前的聊天、父级对话或内存文件中没有的历史上下文时,使用本技能检索和统计会话记录。

数据位置:日志位于 ~/.openclaw/agents/<agentId>/sessions/,agentId 取自系统提示 Runtime 行中的 agent=<id>。其中 sessions.json 是会话键到会话 ID 的索引;每个 <session-id>.jsonl 是一个会话的完整记录。

结构:每个 .jsonl 文件按行存放 JSON 对象,含 type(session 元数据或 message)、timestamp(ISO 时间)、message.role(user、assistant 或 toolResult)、message.content[](文本、思考或工具调用,筛 type=="text" 可得可读内容)、message.usage.cost.total(每次回答费用)。

常见查询:可按日期和大小列出所有会话、查找某一天的会话、提取某会话的用户消息、在助手回答中搜索关键词、统计某会话总费用、生成每日费用汇总、统计消息与时序、按工具调用做使用分布,以及跨全部会话搜索短语。示例命令如 jq -r 'select(.message.role == "user") | .message.content[]? | select(.type == "text") | .text' <session>.jsonl,或 rg -l "phrase" ~/.openclaw/agents/<agentId>/sessions/*.jsonl。

提示与限制:会话是仅追加的 JSONL,每行一个 JSON 对象;大文件可达数 MB,宜用 head/tail 抽样;sessions.json 索引把聊天来源映射到会话 ID;被删除的会话带 .deleted.<timestamp> 后缀。资料未提供关于收费、价格、平台支持范围或效果保证的信息。