session-continuity — 会话连续性
v1.0.0在会话即将结束但仍有未完成工作时使用,或者在上下文丢失或压缩、崩溃后,或者当用户想要恢复多步骤任务时。保存当前任务状态、进度、阻塞器和下一步操作的命名检查点,以便下一个会话从确切的恢复点开始 —— 而不是从头开始。检查点可以在会话死亡后幸存并堆叠(深度恢复)以支持多天的工作流。建立在proactive-agent的WAL Protocol之上:WAL捕获每条消息的决策;检查点捕获任务级别的恢复状态。可以在关闭信号、高上下文或用户明确请求保存/恢复时自动激活。基于API和CLI的激活也支持GitHub等平台的集成。
运行时依赖
安装命令
点击复制本土化适配说明
session-continuity — 会话连续性 安装说明: 安装命令:["openclaw skills install session-continuity"]
技能文档
会话连续性 保存您的位置。即使几天后,也可以从您离开的地方继续。
核心位置 大多数代理在会话结束时会丢失所有状态。这个技能将检查点视为一等公民的工件:在上下文处于风险之时之前主动写入,在会话开始时自动读取,用于恢复完整的工作上下文。这不是“记笔记”。检查点是一种机器可读的恢复信号。如果它不能恢复下一个操作的确切位置以及执行它所需的上下文,则检查点是不完整的。
模式 /checkpoint save 将当前任务状态保存到一个名为的检查点文件中。在关闭任何具有未完成工作的会话之前,在手动重置之前,接近上下文限制时,或任务跨多个会话时使用。当: 关于关闭具有活动工作的会话 上下文 > 70%且工作未完成 多天任务,明天需要继续 达到里程碑后,标记恢复点 不适用于: 一次性任务,在单个回复中完成。 /checkpoint save meeting-prep /checkpoint save build-login-page --task "使用 OAuth 回退构建登录页面" /checkpoint save analyze-q1-data 保存内容: 任务名称和一行摘要 当前进度(已完成的内容) 阻塞器和不确定性 确切的下一步操作(下一个命令或步骤) 相关文件路径和最近的决定 继续所需的上下文片段 输出: 带有检查点名称和文件路径的确认。
/checkpoint list 列出工作区中的所有可用检查点。当: 开始新会话并希望查看剩余内容 用户询问“什么是我正在做的?” 开始工作之前,希望检查是否有现有的恢复点 输出: 带有名称、创建时间、任务摘要和年龄(自上次保存以来的时间)的检查点表。
/checkpoint resume 读取检查点并将会话恢复到该恢复点。当: 会话开始时存在最近的检查点 用户说“继续我们离开的地方”,“恢复任务 X” 检测到
标签或压缩恢复信号 用户询问“我们在哪里停下来?” 行为: 读取检查点文件 显示任务摘要和最后的进度 声明确切的下一步操作 在继续之前确认 - 用户必须批准恢复 输出: “恢复:[任务名称]。最后的进度:[摘要]。下一步操作:[操作]。准备继续吗?(是/否)”/checkpoint delete 删除一个名为的检查点。当任务完全完成且检查点不再需要时使用。 不适用于: 存档 - 只有在任务真正完成时才删除。
执行步骤 对于 /checkpoint save 在写入之前,收集上下文: 阅读 SESSION-STATE.md - 这是 WAL 源;它包含活动任务状态、决策、当前目标 扫描对话历史 - 会话开始以来完成了什么? 验证目录是否存在 - 运行 ls memory/checkpoints/;如果缺失,则创建它 草拟检查点内容 - 填写检查点文件格式的每个部分: 任务:一行摘要(从 SESSION-STATE.md 和对话中推断) 进度:特定的已完成项 - 文件路径、行范围、命令输出 下一步操作:确切的下一步操作 - 哪个文件要编辑,哪个命令要运行 阻塞器:具有名称和错误消息的具体障碍 关键决策:导致当前状态的推理,而不仅仅是事实 相关上下文:文件路径、用户首选项、任何不能从文件中推断出的内容 将完成的检查点写入 memory/checkpoints/.md 向用户确认:检查点名称、任务、下一步操作 命名规则(严格): 使用 kebab-case:build-login-page、q1-data-analysis 必须足够具体,以便一眼识别任务 禁止使用的名称:task、work、save、untitled、backup 如果 SESSION-STATE.md 为空: 完全从对话中推导检查点内容。 不要仅因为 SESSION-STATE.md 为空而跳过检查点。
对于 /checkpoint resume 阅读 memory/checkpoints/.md 验证引用的文件仍然存在 - 检查检查点中的每个文件路径;标记任何丢失或更改的文件为潜在过时文件 以结构化恢复简报的形式呈现检查点: 📌 恢复:<任务名称> 保存:<日期> (<年龄>) ✅ 进度:
- <项目 1>
- <项目 2>
/checkpoint auto 协议(内部) 不是用户可调用的模式。 代理扫描每条消息以查找这些触发信号并自主执行: 触发信号(按优先顺序扫描): 上下文 > 70% - 调用 session_status;如果 usedTokens/contextWindow > 0.70,则触发 关闭信号 - 用户说“晚安”、“logout”、“exit”、“明天见” 空闲且有工作 - 会话空闲 > 10 分钟且 SESSION-STATE.md 非空 长时间操作 - 即将运行预计需要 > 30 秒的命令 当触发时: 阅读当前 SESSION-STATE.md 内容 写入 memory/checkpoints/...