用途:当用户询问之前的聊天、父级对话或记忆文件中没有的历史上下文时,使用该技能搜索完整对话历史。
日志位置:会话日志位于 ~/.openclaw/agents/<agentId>/sessions/,其中 agentId 取自系统提示 Runtime 行的 agent=<id> 值。sessions.json 是会话键到会话 ID 的索引;<session-id>.jsonl 是每个会话的完整对话记录。
结构:每个 .jsonl 文件包含 type 为 session(元数据)或 message 的消息,含 timestamp、message.role(user、assistant、toolResult)、message.content[](文本、思考或工具调用,过滤 type=="text" 可得可读内容)、message.usage.cost.total(每次响应成本)。
常见查询:可按日期和大小列出所有会话;查找某一天的会话;提取某会话的用户消息;在助手回复中搜索关键词;统计某会话总成本;生成每日成本汇总;统计会话消息数与 token;统计工具使用分布;跨所有会话搜索短语。
提示:会话为仅追加的 JSONL,每行一个 JSON 对象;大会话可达数 MB,可用 head/tail 采样;sessions.json 索引将聊天提供方(discord、whatsapp 等)映射到会话 ID;已删除会话带 .deleted.<timestamp> 后缀。
限制:资料未提供安装方式、收费、价格、平台支持或效果说明。