任务监控器
task-watchdog
by axelhu
任务锁与超时监控系统。外部文件承载任务状态,不污染 agent 上下文,纯靠 heartbeat + GRACE 判断,不发即时告警。
安装
claude skill add --url https://github.com/openclaw/skills文档
Task Watchdog
核心概念
Lock 文件是任务的外部状态载体,放于 ~/.openclaw/agents/{agent_id}/locks/:
active/— 正在执行的任务archive/YYYY-MM-DD/— 归档(done / abandoned / timeout)
两个时间字段,职责不同:
last_heartbeat — lock-self-check 更新(纯心跳维持,不说明任务有进展)
last_progress — lock-update --progress 时更新(标记真实进展)
状态判断(用 last_progress,不看 last_heartbeat):
✅ 正常 session 存在,last_progress 正常
⚠️ SESSION_DEAD session 已消失
⚠️ STALLED session 存在,但 last_progress 超 GRACE×3
⚠️ HEARTBEAT_DELAY 心跳延迟
🚫 abandoned session 消失 + last_progress 超 GRACE×3
📦 done 任务完成,立即归档
脚本
| 脚本 | 用途 |
|---|---|
lock-create.sh | 创建 lock → active/ |
lock-update.sh | 更新 heartbeat;--progress 时同时更新 last_progress |
lock-done.sh | 标记完成 → 归档 |
lock-status.sh | 查询状态 |
scan-locks.sh | 扫描 active/,异常归档 |
lock-archive.sh | 归档N天前 / 清理N天前 / 统计 |
lock-report.sh | 查看所有活跃任务状态 |
lock-self-check.sh | Agent 自检:更新心跳 + 处理 abandoned |
推荐用法
关键节点调用:
任务开始 → lock-create
每个关键步骤完成 → lock-update --progress "X完成,开始Y"
任务全部完成 → lock-done
HEARTBEAT 触发时调用自检:
收到心跳轮询时
→ 调用 lock-self-check.sh
→ 自动完成:
无活跃任务 → 无输出,agent 回复 HEARTBEAT_OK
owner session 存活 → 只更新 last_heartbeat
owner session 已死 → 接管任务(更新 session_id + last_heartbeat)
→ 无需判断逻辑,脚本自动处理
设计目标
任务续做保障系统,不是即时告警系统:
- 中断后 lock 留在 active/,Supervisor 扫描归档
- 自检机制让 agent 自动继续被中断的任务
- 定期报告让负责人知道哪些任务需要接管或放弃
常用命令
./lock-self-check.sh --agent-id xxx --session-id xxx # HEARTBEAT 触发时调用
./lock-report.sh # 查看所有活跃任务状态
./lock-archive.sh --list # 同上
./lock-archive.sh --archive-days 7 # 归档7天前完成的任务
./lock-archive.sh --cleanup-days 30 # 清理30天前的归档
相关 Skills
技能工坊
by anthropics
覆盖 Skill 从创建到迭代优化全流程:起草能力、补测试提示、跑评测与基准方差分析,并持续改写内容和描述,提升效果与触发准确率。
✎ 技能工坊把技能从创建、迭代到评测串成闭环,方差分析加描述优化,特别适合把触发准确率打磨得更稳。
PPT处理
by anthropics
处理 .pptx 全流程:创建演示文稿、提取和解析幻灯片内容、批量修改现有文件,支持模板套用、合并拆分、备注评论与版式调整。
✎ 涉及PPTX的创建、解析、修改到合并拆分都能一站搞定,连备注、模板和评论也能处理,做演示文稿特别省心。
PDF处理
by anthropics
遇到 PDF 读写、文本表格提取、合并拆分、旋转加水印、表单填写或加解密时直接用它,也能提取图片、生成新 PDF,并把扫描件通过 OCR 变成可搜索文档。
✎ PDF杂活别再来回切工具了,文本表格提取、合并拆分到OCR识别一次搞定,连扫描件也能变可搜索。
相关 MCP 服务
文件系统
编辑精选by Anthropic
Filesystem 是 MCP 官方参考服务器,让 LLM 安全读写本地文件系统。
✎ 这个服务器解决了让 Claude 直接操作本地文件的痛点,比如自动整理文档或生成代码文件。适合需要自动化文件处理的开发者,但注意它只是参考实现,生产环境需自行加固安全。
by wonderwhy-er
Desktop Commander 是让 AI 直接执行终端命令、管理文件和进程的 MCP 服务器。
✎ 这工具解决了 AI 无法直接操作本地环境的痛点,适合需要自动化脚本调试或文件批量处理的开发者。它能让你用自然语言指挥终端,但权限控制需谨慎,毕竟让 AI 执行 rm -rf 可不是闹着玩的。
EdgarTools
编辑精选by dgunning
EdgarTools 是无需 API 密钥即可解析 SEC EDGAR 财报的开源 Python 库。
✎ 这个工具解决了金融数据获取的痛点——直接让 AI 读取结构化财报,比如让 Claude 分析苹果的 10-K 文件。适合量化分析师或金融开发者快速构建数据管道。但注意,它依赖 SEC 网站稳定性,高峰期可能延迟。