用途:为智能体添加周期性心跳,按 cron 计划自动唤醒,逐项运行 HEARTBEAT.md 中的检查清单,只有确实需要用户注意时才发送消息,否则保持静默。
主要能力:创建 groups/main/HEARTBEAT.md 模板清单;注册定时任务(默认每 30 分钟一次);内置检查示例包括错误日志(读取 ~/nanoclaw/logs/errors.log,按 time 字段过滤 35 分钟内新增条目)、异常进程(ps aux -r 检查 CPU 超 90% 及 uptime 负载超 4,可 kill 僵尸 Chrome 进程 pkill -9 -f "agent-browser-chrome")、磁盘空间(df -h /,使用率超 80% 告警)。
使用方式:先创建 groups/main/HEARTBEAT.md;用 AskUserQuestion 询问运行频率(每 30 分钟/每小时/每 2 小时)及要添加的检查;然后写入 IPC 任务文件注册心跳,prompt 提示读取 $GHOSTCLAW_GROUP_DIR/HEARTBEAT.md 或 ./HEARTBEAT.md,schedule_type 为 cron,默认 schedule_value 为 */30 * * * *,context_mode 为 isolated;最后用 grep -i "heartbeat|All checks passed" ~/nanoclaw/logs/ghostclaw.log | tail -5 验证。用户可随时编辑 HEARTBEAT.md 增删改检查项,智能体每次重新读取,无需重启。
规则与限制:默认静默,全部正常时仅返回 <internal>All checks passed</internal>;不解释推理过程;不报告过期条目;告警用平实语言,最多一两行;不重复近期会话中已出现的告警。可添加的检查示例包括 curl 网站存活、gh pr list 查看 PR、grep ERROR 查应用日志、检查 Gmail 邮件、通过 API 查加密货币价格。具体可用性、收费与平台要求暂未提供。