session-logs 是一个用于检索和分析自身会话日志的技能,适合在用户提到较早或父级对话、询问此前说过什么时使用。它面向存储在 session JSONL 文件中的完整对话历史,帮助找回不在记忆文件中的上下文。
会话日志位于 ~/.clawdbot/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(每次回复的费用)。
该技能给出的常见查询包括:按日期和大小列出全部会话;查找指定日期的会话;提取会话中的用户消息;在助手回复中按关键词搜索;计算单次会话总费用;生成每日费用汇总;统计会话中的消息数量、token 及首尾时间;分析工具使用分布;跨全部会话搜索短语。此外还提供一个低噪声的纯文本快速搜索提示。
使用方式以命令行 jq 查询为主,必要时配合 rg 进行文本搜索。会话文件为追加式 JSONL,每行一个 JSON 对象;大型会话可能达到数 MB,可用 head 或 tail 抽样处理。sessions.json 索引记录聊天提供方(如 discord、whatsapp 等)与会话 ID 的映射;已删除会话带有 .deleted.<timestamp> 后缀。
适用场景包括回溯先前对话、找回历史上下文、核算会话费用和审计对话记录。限制方面,资料未提供图形界面、自动摘要或跨代理聚合等额外功能,使用前需确认代理会话目录和工具环境。