Task Persistence

任务连续性、会话快照以及网关重启恢复。用于启动长时间运行的任务(注册任务)和网关重启后(检查任务状态)

安装

概览

什么是Task Persistence

Task Persistence 是一个专为长时间运行任务设计的系统级持久化与恢复工具,旨在解决因网关重启、意外中断或系统崩溃导致的任务丢失问题。它通过自动保存任务状态到磁盘,并在系统恢复后智能检测并重建未完成任务,确保关键操作不因短暂中断而失败。该工具不仅支持单个任务的暂停、恢复和取消,还提供了完整的多任务队列管理能力,让用户可以灵活控制并行执行的工作流。 除了任务层面的持久化,Task Persistence 还集成了会话快照功能,能够定期保存对话上下文和历史记录,并在重启后从最近的快照中快速恢复,极大提升了多轮交互场景下的连续性体验。结合 OpenClaw 的 memory-core 插件,系统还能对历史信息进行智能压缩与向量检索,保留关键语义而不占用过多资源。此外,内置的网关监控模块可实时追踪服务状态,主动通知重启完成事件,并支持周期性健康检查,形成一套闭环的系统可靠性保障机制。 整体而言,Task Persistence 将任务管理、状态恢复与系统监控融为一体,适用于需要高可用性和容错能力的自动化工作流环境。无论是数据导入、文件处理还是后台批量作业,都能借助其机制实现无缝衔接与稳定运行。

核心功能特点

  1. 自动保存长时间运行任务的状态至本地磁盘,避免因意外中断造成的数据丢失
  2. 支持多任务队列管理,包括暂停、恢复、取消及并发数量控制
  3. 提供会话快照功能,定期保存对话上下文并在重启后智能恢复历史状态
  4. 集成网关监控模块,实时检测服务状态并主动发送重启完成通知
  5. 与 memory-core 插件协同工作,实现历史记录的向量压缩与语义检索
  6. 配置灵活,可通过命令行或 JSON 配置文件自定义各项参数与行为

适用场景

Task Persistence 特别适用于那些需要持续运行数分钟甚至数小时的长周期任务场景,例如大规模文件上传下载、数据库批量迁移、日志分析处理等。在这些场景中,网络波动、系统维护或临时断电都可能导致任务中断,而传统脚本往往缺乏恢复能力。借助 Task Persistence,即使网关重启,系统也能自动识别未完成的工作项并从中断点继续执行,显著提升作业成功率与用户体验。 在日常运维和开发环境中,该工具同样表现出色。当开发者进行网关更新、依赖升级或配置变更时,无需担心正在进行的任务会被强制终止。只需在变更前创建快照,更新完成后即可一键恢复现场,极大简化了部署流程。同时,对于需要长期值守的服务(如定时爬虫、监控告警系统),内置的健康检查与异常告警功能可帮助及时发现潜在问题,防止静默故障影响业务稳定性。 更广泛地说,任何依赖会话上下文的 AI 辅助开发或交互式调试场景均可受益于其会话快照机制。例如,在一次复杂代码重构过程中,工程师可能多次中断以查阅文档或测试片段。使用 Task Persistence 后,所有讨论脉络与中间结果都会被安全存储,重启 IDE 或代理网关后仍能无缝回到之前的思考节点,避免重复劳动并提高决策效率。这种细粒度的状态管理能力,使得复杂人机协作流程更加可靠和可预测。