（896期）ContextClaw Plugin Usage – 智能会话分析与安全清理工具

智能会话分析与安全清理工具 OpenClaw 插件，用于分析、可视化和清理会话存储，支持安全预览删除、保护主代理会话，帮助用户管理磁盘空间和上下文消耗。 使用说明 ContextClaw 插件综合评估 核心用法 ContextClaw 是 OpenClaw 生态系统的会话管理插件，主要解决 AI 代理长期运行产生的会话数据膨胀问题。用户通过 CLI 命令执行四类操作： 分析诊断：openclaw contextclaw analyze 提供全局统计，包括会话总数、消息量、Token 消耗、存储大小，并识别最大的 10 个会话、最旧的 10 个会话及孤儿会话 智能清理：prune 命令按年龄阈值（默认 30 天）删除旧会话，clean-orphaned 移除未被 sessions.json 引用的孤立文件 可视化仪表板：本地 Web 界面（默认端口 18797）提供图表展示、类型分布和快速操作 状态监控：status 命令快速检查运行状态 显著优点 安全第一的设计：所有删除操作默认启用 dry-run 模式，必须显式关闭才会实际执行；主代理会话和 cron 会话受保护无法误删 多维度洞察：不仅显示体积，还按会话类型（main/cron/subagent/unknown）分类，帮助用户理解数据构成 精准定位问题："孤儿会话"识别机制解决了开发测试、崩溃恢复等场景下的文件残留问题 交互式确认：prune 操作后提示用户二次确认，降低误操作风险 潜在缺点与局限性 Token 估算粗糙：采用 1 token ≈ 4 字符的近似算法，与实际 LLM tokenizer 计数存在偏差，不适合精确计费场景 本地单机架构：仪表板绑定 localhost，无法远程管理多机部署的 OpenClaw 实例 手动运维导向：缺乏自动化的保留策略（如"保持最近 N 个"或"总大小上限"），需用户定期手动执行 数据只读：仅分析文件系统，不提供更深入的对话内容检索或语义搜索能力 适合人群 长期运行 OpenClaw 代理的开发者或运维人员 需要诊断"为什么磁盘快满了"的排查场景 注重操作安全、偏好预览再执行的数据清理 cautious 用户 希望可视化理解会话分布的技术用户 常规风险 路径依赖风险：解析固定路径 ~/.openclaw/agents/main/sessions/，若用户自定义配置可能导致分析遗漏 并发操作风险：在 prune 执行期间若有新会话写入，可能出现竞态条件（文档未提及锁机制） 误删边界情况：虽然保护 main/cron，但 subagent 会话若被其他进程引用可能产生运行时错误 端口冲突：默认 18797 端口若被占用需手动重配置 原始说明 Manage and analyze OpenClaw sessions by checking usage, pruning old sessions, cleaning orphaned files, and viewing stats via CLI or dashboard.