OpenClaw 会话历史管理

问题从哪来

OpenClaw 把对话持久化成 .jsonl 会话文件。调试、纠错或清理「刚发错的那一轮」时，直接在编辑器里改 JSONL 容易误删结构、破坏行边界，也难在删前确认到底会去掉哪几条消息。

技能在做什么

chat-history-manager 是一组基于 Node.js 的 .cjs 脚本（依赖均为内置模块），在 Windows / macOS / Linux 上统一操作会话目录，不依赖 PowerShell。

典型流程：

• 用 list-sessions.cjs 查看现有会话
• 用 preview-last-turn.cjs 只预览即将删除的最新一轮问答，不写入磁盘
• 确认后用 delete-last-turn.cjs 删除最新一轮；删除前会自动备份，删除后会校验，失败则回滚
• 误操作可用 restore-session.cjs 从备份恢复；cleanup-backups.cjs 清理旧备份
• export-txt.cjs 将会话导出为可读 txt

按会话定位时，--label 会按评分选目标（精确匹配优先，其次大小写、分隔符变体、标签包含、UUID 片段等）。多个候选得分接近时会触发歧义保护，避免删错会话。默认删除需确认；加 --yes 可跳过交互。

边界与注意

脚本输出刻意控制在 1～4 行，适合在终端里快速扫一眼。删除成功后，OpenClaw 界面不会自动刷新，需要关闭并重新打开对应 Tab 才能看到最新历史。

若某环境下 .cjs 出现路径或编码异常，可回退到同名的 .ps1 脚本（参数与旧版文档或 scripts/ps1_backup/ 中的说明略有差异）。