会话日志检索

技能简介

该技能用于搜索和分析存储在本地 JSONL 文件中的完整对话历史，支持按日期、关键词、角色等维度检索过往会话内容，并可统计会话成本与消息数量。

业务背景

运营团队需回溯历史服务记录或审计对话质量时，该技能支持按日期、关键词、角色等多维度检索本地存储的完整会话日志。可快速定位特定客户沟通内容，统计单次或每日会话成本与消息量，为服务质量复盘和费用管控提供数据支撑。

落地案例：客服主管收到客户投诉称上月某次沟通承诺未兑现，通过该技能输入客户ID作为关键词，筛选过去30天会话文件，提取所有助手回复消息定位到具体对话。同时调取该会话元数据，确认消息数12条、Token消耗3,200、成本0.08美元，结合完整对话内容完成事件核查并生成处理报告。

能做什么

• 列出所有会话的日期、大小和文件名
• 按日期筛选特定会话
• 提取用户或助手的文本消息
• 跨所有会话搜索关键词
• 计算单次或每日会话总成本
• 统计消息数、Token 消耗及工具调用情况

使用说明

安装依赖

# 安装 jq（JSON 处理器）
# macOS
brew install jq

# Ubuntu/Debian
sudo apt-get install jq

# 安装 ripgrep（rg）用于文本搜索
# macOS
brew install ripgrep

# Ubuntu/Debian
sudo apt-get install ripgrep

基本用法

会话日志位于 ~/.clawdbot/agents/<agentId>/sessions/ 目录下，其中 sessions.json 为索引文件，<session-id>.jsonl 为各会话的完整记录。

常用命令示例：

# 查看某会话的所有用户消息
jq -r 'select(.message.role == "user") | .message.content[]? | select(.type == "text") | .text' <session>.jsonl

# 搜索助手回复中的关键词
jq -r 'select(.message.role == "assistant") | .message.content[]? | select(.type == "text") | .text' <session>.jsonl | rg -i "keyword"

# 获取会话总成本
jq -s '[.[] | .message.usage.cost.total // 0] | add' <session>.jsonl

输入与输出

见下方输入与输出表格。

风险提示

• 会话文件可能达数 MB，建议先用 head/tail 采样查看
• 删除的会话会带有 .deleted.<timestamp> 后缀，需注意识别
• 成本统计依赖 message.usage.cost.total 字段，缺失时返回 0
• 跨会话搜索大量文件时，rg 命令可能消耗较多系统资源

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/guogang1024/session-logs/SKILL.md
来源类型：GitHub 仓库