Live Task Pulse

实时任务进度跟踪与即时推送通知。对所有多步骤任务(>30秒或>2次工具调用)强制启用,自动激活,无需等待。

安装

概览

什么是Live Task Pulse

Live Task Pulse 是一款专为解决多步骤任务执行过程中进度不可见问题而设计的实时任务跟踪工具。它通过将任务拆分为多个步骤,并在每个关键节点自动向用户推送即时通知,确保用户在任务进行中始终掌握最新进展。与其他仅写入文件、需要主动查询才能获取进度的传统方式不同,Live Task Pulse 利用 OpenClaw 的 `message` 工具,直接将每一步的状态变化推送到用户的聊天界面(如 Telegram、Discord 等),实现真正的实时透明化操作。

该工具采用双层次架构:一方面通过 JSON 文件持久化保存任务状态,保障系统崩溃后的数据恢复能力;另一方面则通过消息推送机制,让用户无需轮询或主动查询即可感知任务动态。这种设计尤其适用于耗时较长(超过30秒)或涉及多次工具调用的复杂流程,例如数据抓取、批量处理、自动化部署等场景。任务一旦创建,系统会自动激活并强制启用进度跟踪,无需额外配置或等待。

Live Task Pulse 不仅支持任务的创建、推进、完成和失败等基本操作,还具备心跳检测与卡死预警功能。当某个步骤执行时间过长且无更新时,系统会在检测到停滞后主动推送警告信息,帮助用户及时发现异常。此外,工具内置自动清理机制,可定期删除超过7天的已完成任务记录,避免存储膨胀。整体而言,它是一个轻量级但功能完备的命令行工具,旨在提升自动化任务的可观测性与用户体验。

核心功能特点

  1. 实时推送任务进度至用户聊天界面,无需手动查询
  2. 自动识别长耗时任务并触发心跳更新,防止信息滞后
  3. 支持任务卡死检测,超时3分钟未更新即发送预警通知
  4. 基于 JSON 文件持久化存储,保障系统异常时状态不丢失
  5. 兼容多种通信渠道,自动适配当前活跃的消息通道
  6. 内置自动清理机制,保留已完成任务最多7天

适用场景

Live Task Pulse 特别适用于那些需要长时间运行或多阶段协作的自动化任务场景。例如,在构建 CI/CD 流水线时,当一个部署任务包含编译、测试、打包等多个环节时,开发者可以通过 Live Task Pulse 在每个阶段完成后立即收到进度反馈,从而快速判断是否出现阻塞或错误。同样,在数据爬取或 ETL 流程中,若某一步骤耗时超过一分钟,使用 heartbeat 接口报告处理进度能有效缓解用户对‘程序是否还在运行’的焦虑。

对于依赖子代理(sub-agent)协同工作的智能体系统,主代理可以创建全局任务,并将具体执行委托给下游代理;下游代理只需更新对应的任务文件,主代理便能通过消息推送同步所有子任务的进展。这种模式极大提升了分布式任务调度的可见性和可控性。此外,结合 cron 定时任务使用时,可将脚本包装为 create-next-done 的完整生命周期管理,确保即使无人值守的后台作业也能被有效监控。

无论是个人开发者调试复杂脚本,还是团队运维大规模自动化作业,Live Task Pulse 都能显著增强任务透明度,减少沟通成本,提高故障排查效率。其零配置启动特性也意味着接入成本低,几乎不需要学习曲线即可融入现有工作流。