Cron Gate 是一款专为 OpenClaw 设计的零成本 Python 守护脚本,旨在显著降低 LLM(大语言模型)定时任务的 Token 消耗。许多用户每天运行多个记忆集成 cron 任务,即使会话中并无新消息,这些 cron 仍会触发完整的 LLM 会话,导致大量无谓的 Token 开销——包括提示加载、Weave 文件处理及工具调用等。Cron Gate 通过前置轻量级检查机制,在真正需要时才唤醒昂贵的 LLM 进程,从而有效避免资源浪费。其核心原理是利用系统 crontab 定期执行一个纯 Python 脚本,该脚本读取 `sessions.json` 中的时间戳信息,并与本地状态文件对比,仅在有实际新活动发生时,才通过 API 触发对应的 OpenClaw cron。整个过程不涉及任何 LLM 调用,因此自身运行成本为零,但能带来显著的 Token 节省效果。
核心功能特点
- 零 Token 消耗:作为纯 Python 脚本运行,不调用任何 LLM,自身开销几乎为零
- 智能预检机制:通过比对会话最后更新时间与上次触发记录,精准判断是否需要唤醒 LLM
- 灵活配置支持:可自定义会话到 cron 的映射关系,支持按时间段(如早晚)分组管理
- 自动时间窗口识别:根据 UTC 小时自动判断运行时段(如 4-8 UTC 为晚间窗口),也支持手动指定
- 状态持久化存储:使用本地 JSON 文件记录各会话的最后触发时间,确保状态一致性
- 兼容性强:适用于任何可通过简单检查判断“是否无事可做”的周期性 LLM 任务
适用场景
Cron Gate 特别适合那些频繁运行但多数情况下并无实际工作负载的场景。例如,当你在多个平台(如 Telegram 群组、Discord 频道)部署代理并启用每日两次的记忆同步功能时,传统方式会导致大量空闲会话被唤醒,白白消耗数百甚至上千 Token。借助 Cron Gate,只有当某个会话中有新消息到达时,才会触发对应的 cron 任务,其余时间则保持静默,极大优化了资源利用率。此外,该工具不仅限于内存集成场景,还可扩展应用于邮箱轮询、社交媒体内容抓取、通知提醒等多种周期性任务中——只要存在一种低成本的方式可以确认‘当前无新内容’,就可以用 Cron Gate 进行前置过滤。这种‘先查后做’的模式尤其适合高频率、低活跃度或跨多实例部署的环境,帮助用户在不牺牲功能的前提下实现显著的运营成本控制。
