session-logs

• 用户询问"我们上周聊了什么？"或引用当前记忆中不存在的先前对话。
• 您需要计算会话费用、统计消息数量，或汇总历史聊天中的工具使用情况。
• 您希望快速在所有历史会话中搜索特定关键词或短语。
• 您需要通过日期、大小或提供方（Discord、WhatsApp 等）使用 sessions.json 索引来识别会话。

• 当前对话窗口或记忆文件中已有你所需的上下文——无需访问文件系统。
• 你所在的环境中 ~/.openclaw/agents/ 会话存储不存在或无法访问。

使用 rg（ripgrep）通过单条命令在所有会话 JSONL 文件中搜索短语或关键词。无需逐个手动读取文件，即可快速定位哪些会话包含相关内容。

使用 jq 选择器对 .message.role 和 .message.content[].type 字段进行查询，可独立提取用户消息、助手回复、工具调用或思考块。自动过滤掉工具结果等干扰信息。

通过对单个会话或按天汇总所有会话的 message.usage.cost.total，生成成本摘要。同时支持统计消息数量、计算会话时长，以及按频率分析工具使用情况。

列出按日期和文件大小排序的所有会话，查找特定日期的会话，或查阅 sessions.json 将聊天提供商（Discord、WhatsApp 等）映射到会话 ID。

会话记录是仅追加的 JSONL 文件，可能增长至数 MB。session-logs 技能的查询模式包含 head/tail 采样技巧以及流式 jq 用法，以避免不必要地将整个文件加载到内存中。

当用户说"还记得我们上个月讨论过 X 吗？"时，智能体会使用 session-logs 技能按日期或关键词搜索会话文件，并将相关对话内容呈现出来，即使该内容已不在当前活跃的上下文窗口中。

开发者希望了解每次对话的费用情况。该技能通过 session-logs 按会话汇总 cost.total，并按天分组统计结果，从而生成覆盖整个智能体历史记录的可读费用明细。

一位操作员想了解智能体最频繁调用哪些工具。该技能从 session-logs 中提取 toolCall 条目，对其进行计数并排序——有助于调试或优化智能体的行为。

用户询问某个特定主题（例如项目名称、某项决策）是否曾被讨论过。代理对所有 JSONL 文件运行 ripgrep 搜索，并返回匹配的会话路径以供进一步探索。