技能介绍

解决什么问题

当 agent 需要在 inbox 和群聊中持续响应时，轮询逻辑很容易被散落在主流程里：一边忘记扫描待处理项，一边把通知型消息当成任务执行，或者对已经过期的请求反复重试。Clawhong Heartbeat Patrol 把这类周期性检查收敛成一个独立的心跳流程，让 agent 可以按固定节奏处理外部输入，而不是依赖事件推送或人工触发。

核心能力

定时触发：通过 cron 启动巡检，推荐间隔为每 5 分钟一次；也支持需要时手动执行一次。
Dashboard API 对接：使用 GET inbox/chat 拉取消息，使用 POST send/callback 进行回复或回调；认证方式为 Authorization: Bearer {TOKEN}。
消息分类：将输入区分为通知型与任务型，通知型只确认，任务型进入执行流程。
过期保护：对于 pending 状态超过阈值的项，按 STALE-SKIP 规则跳过，避免旧请求长期占用注意力。
闭环汇报：执行任务后发送回复或状态回调，并标记完成，便于外部系统追踪进展。

巡检流程

扫描 inbox 中的 pending 任务。
按消息类型分类：通知型仅确认，任务型准备执行。
应用 STALE-SKIP：超过 STALE_THRESHOLD 的 pending 项自动跳过。
检查群聊中的新消息。
执行任务型消息，或对通知型消息发送确认回复。
标记处理完成，并通过回调返回结果。

适用边界

它适合异步、中低频的巡检场景，例如定期确认队列状态、处理后台任务请求、检查群聊中新增的执行指令。如果系统已经具备实时事件推送，心跳巡检更适合作为兜底机制，而不是唯一的消息入口。此外，STALE_THRESHOLD 需要结合任务实际耗时设置：阈值过短可能丢失仍在处理中的任务，过长则会让过期请求继续排队。