核心用法
Context Compression 是一套面向 OpenClaw 代理系统的上下文管理工具集，通过定时截断会话文件防止 Token 溢出。用户通过交互式向导完成配置后，由 crontab 定期执行 truncate-sessions-safe.sh，将超出长度限制的 JSONL 会话文件安全裁剪至设定阈值。截断前自动调用事实识别模块，提取关键词或经 AI 判定的重要信息写入记忆文件。
显著优点
- 安全截断机制：采用
.lock文件检测跳过活跃会话，截断前生成.pre-trim备份，且严格保证 JSONL 行边界完整 - 智能内容保留：
priority-first策略优先保留含关键词（重要、TODO、deadline 等）的会话行，降低关键信息丢失风险 - 双层事实识别：默认本地关键词扫描零网络传输；可选开启 AI 辅助识别，由本地 OpenClaw CLI 调用，数据流向取决于用户配置
- 记忆生命周期管理：支持偏好设置带过期标签（@YYYY-MM-DD），自动清理短期/中期/长期记忆
- 会话钩子集成：提供
session-start-hook.sh与session-end-hook.sh供 AGENTS.md 调用，实现上下文自动加载与保存
潜在局限
- 依赖外部调度：本身无守护进程，需用户自行配置 crontab，新手可能因 PATH 或权限问题导致调度失败
- AI 识别风险：
identify-facts-enhanced.sh启用后，内容可能经本地 OpenClaw CLI 发往远程 LLM，存在隐私泄露隐患，且默认关闭 - 关键词局限：纯关键词模式对语义理解有限，可能漏捕未命中关键词的重要信息
- 备份清理：
.pre-trim备份在成功写入后清理，若进程中断可能残留临时文件
适合人群
- 高频使用 OpenClaw 代理且会话长度易超 Token 限制的高级用户
- 需要长期维护项目记忆、偏好与任务列表的开发者或知识工作者
- 具备基础 Linux 运维能力、能独立配置 crontab 与排查 PATH 问题的技术用户
常规风险
- 数据完整性：虽保证行边界，但大文件并发截断仍存在极低概率的 I/O 异常风险
- 隐私合规：启用 AI 识别时需确认 OpenClaw 配置中的 LLM 服务商隐私政策
- 权限越界：脚本需读写
~/.openclaw/agents/main/及~/.openclaw/workspace/memory/，配置不当可能导致其他用户数据被误读（实际通过路径严格限定缓解）