task-status

📡 长任务实时心跳通知专家

Clawdbot 官方任务状态通知技能,通过 Telegram 实时推送长任务进度,解决异步操作中的用户等待焦虑问题。

收藏
18.4k
安装
3.7k
版本
127.0.0
CLS 安全性认证2026-05-08
点击查看完整报告 >

使用说明

核心用法

task-status 是专为 Clawdbot 生态设计的任务状态通知技能,解决 AI Agent 执行长耗时操作时用户"黑盒等待"的痛点。它提供两种工作模式:手动状态更新适合 30 秒内的短任务,通过 send_status.py 在关键里程碑推送消息;自动周期监控则针对超过 1 分钟的长任务,,monitor_task.py 以默认 5 秒间隔发送"心跳"更新,直至任务完成。状态类型涵盖 progress(进行中)、success(成功)、error(失败)、warning(警告)四种,每种配有标准化 emoji 标识,消息长度限制 140 字符确保简洁可读。

显著优点

该技能的最大优势在于零侵入集成——无需修改原有业务代码,通过命令行或 Python 导入即可嵌入任何工作流。自动监控模式彻底解放开发者,避免在复杂任务中手动埋点的繁琐。与 Clawdbot 生态深度整合,支持通过 WebSocket 网关或 CLI 双通道发送,且可对接 cron 实现无人值守任务的定时状态检查。消息模板标准化降低了多 Agent 协作时的沟通成本,用户侧获得类 Slack/Discord 的实时进度体验。

潜在缺点与局限性

功能单一性是把双刃剑:它仅支持 Telegram 单通道输出,无法对接企业微信、钉钉等国内常用平台。硬编码路径问题突出——Windows 用户路径 C:/Users/Luffy 和 clawdbot 安装路径写死在代码中,跨平台部署需手动修改。状态文件 .task_status_state.json 缺乏文件锁机制,高频并发场景下可能出现竞态条件。此外,5 秒默认间隔对极短任务过于频繁,而自定义间隔又需额外参数记忆成本。

适合的目标群体

  • Clawdbot 重度用户:已部署该框架的自动化工作流开发者
  • 数据管道工程师:需要监控 ETL、模型训练等小时级任务的进度
  • DevOps 运维人员:CI/CD 流水线中需要实时反馈的部署场景
  • AI Agent 开发者:构建多步骤智能体时提升用户体验的刚需工具

使用风险

1. 依赖项风险:强依赖本地 Clawdbot 网关(默认 127.0.0.1:18789),若网关未启动则所有状态发送失败且无降级方案
2. 网络耦合:Telegram Bot API 在国内访问不稳定,可能导致消息丢失或延迟

3. 资源泄漏:自动监控以独立线程运行,异常退出时可能遗留僵尸进程

4. 信息泄露:状态消息虽经长度限制,但 task_name 和 details 参数可能意外包含敏感路径或业务数据

安全解读

核心用法

task-status 是一套命令行状态推送方案,主要解决长耗时任务"黑盒"焦虑——用户不知道后台进程是否仍在运行。

两种触发模式
1. 自动监控模式monitor_task.py start <任务名> 启动后台线程,每 5 秒自动发送"Still working..."心跳;任务结束后以 stop 子命令上报最终状态

2. 手动打点模式send_status.py "消息" <类型> <标签>,适合短任务或关键里程碑

状态类型:progress(🔄)、success(✅)、error(❌)、warning(⚠️),消息建议控制在 140 字符以内。

进阶场景:支持 --details 附加元数据、自定义心跳间隔(--interval)、Python 模块级导入调用,以及通过 Clawdbot Cron 实现无人值守的定时状态检查。

显著优点

  • 低侵入集成:纯 CLI 接口,任何语言/脚本均可通过 subprocess 调用,无需改造现有业务代码
  • 用户心智安抚:自动 5 秒心跳在长耗时任务(视频转码、大数据同步)中显著降低用户"卡死"焦虑
  • 多层级降级:WebSocket 失败时自动回退到 clawdbot CLI 调用,网络抖动场景下仍能保持基本可用性
  • 状态可恢复monitor_task 依赖本地 JSON 状态文件,支持跨会话查询"哪些任务仍在监控中"

潜在缺点与局限性

  • 外部服务强依赖:消息最终流向 Telegram,若网关或网络故障,状态通知完全中断(离线模式需自行改造)
  • 硬编码默认值:Telegram 目标 ID(7590912486)与网关端口(18789)存在硬编码,误配置可能导致消息发送到非预期会话
  • 并发安全隐患:状态文件读写无文件锁,高频启停监控任务可能触发竞态条件
  • 隐私泄露风险:消息内容默认完整记录到本地 JSONL 日志,若任务信息含敏感数据需自行脱敏

适合人群

  • 运维/开发者需要向 Telegram 实时推送 CI/CD、数据同步、模型训练等长耗时任务进度
  • 个人自动化工作流(Clawdbot 生态用户)追求"后台静默运行、前台状态可见"

常规风险

  • 配置泄露TELEGRAM_TARGETCLAWDBOT_GATEWAY_TOKEN 若写入 shell history 或日志,存在敏感信息暴露风险
  • 消息轰炸:自动心跳间隔过短或任务异常退出未调用 stop,可能导致消息队列堆积
  • 第三方信任:Telegram 服务端与 Clawdbot 网关均为外部依赖,需评估其可用性与数据合规要求

task-status 内容

references文件夹
scripts文件夹
手动下载zip · 14.9 kB
usage.mdtext/markdown
请选择文件