| name | compaction-viewer |
| description | 查看和分析 compaction-debugger 插件生成的预处理和压缩日志。当用户想检查上下文预处理结果、压缩历史或调试上下文问题时使用此技能。 |
| metadata | {"openclaw":{"emoji":"🔍"}} |
Compaction Debugger 查看器
查看和分析 compaction-debugger 生成的日志,包括:
- 预处理后的上下文是否被正确压缩成摘要块
- 压缩前后的 transcript 预览
- 当前会话最近一次 compaction 的输入输出信息
读取重点
- 日志目录:
~/.openclaw/extensions/compaction-debugger/logs
- 关注文件:
assemble-*.json:仅在插件 debug=true 时生成
before-compaction-*.json
after-compaction-*.json
- 如果用户说“我已经发了
/compact,想知道有没有真的触发”,优先看同一个 session 的
before-compaction-* 和 after-compaction-* 是否成对出现
使用规则
- 先列出最新日志文件,再决定读哪一个。
- 如果用户要看“Pi 实际拿到了什么上下文”,优先看最新的
assemble-*.json。
- 如果用户要看“压缩做了什么”,一起对比
before-compaction-* 和 after-compaction-*。
- 总结时说明三件事:
- 是否启用了预处理摘要
- 保留了多少最近消息
- 压缩前后 transcript 有什么变化
- 如果用户怀疑
/compact 没有走真实链路,要明确区分:
openclaw agent --local 的普通对话输入
- gateway
chat.send 触发的真实 slash-command 路由
回复风格
- 优先给结论,再给关键数字。
- 保留原始错误字符串、session id、文件名。
- 如果日志里没有充分信息,明确指出缺口,不要猜测。
示例任务
- 查看最新一次预处理和 compaction 是否正常
- 对比某个 session 的压缩前后 transcript 预览
- 分析为什么 Pi 忽略了较早的历史信息
- 检查
keepRecentMessages 配置是否过小或过大