核心用法
Cron 是一个本地优先的循环调度系统,核心能力在于将用户的自然语言定时意图(如"每周一上午提醒""每三天执行一次")转化为结构化的本地执行计划。用户通过 add_job.py 捕获重复任务,系统支持 daily、weekly、monthly、interval 四种调度类型,并提供 pause_job.py/resume_job.py 实现暂停与恢复控制。
关键工作流围绕可见性设计:next_run.py 让用户明确知晓下一次执行时间,list_jobs.py 与 show_job.py 提供全局与单任务视角,runs.json 与 stats.json 记录执行历史与统计,形成完整的"捕获-执行-追踪"闭环。
显著优点
- 完全本地隔离:数据仅存储于
~/.openclaw/workspace/memory/cron/,零外部依赖、零云端同步,隐私风险极低 - 意图友好:支持自然语言输入,降低非技术用户的调度配置门槛
- 状态可控:
active/paused/archived三态管理,避免僵尸任务堆积 - 零依赖部署:仅需 Python 3,无额外包安装,环境适应性极强
潜在局限
- 单机限制:无多设备同步能力,跨终端场景需手动迁移数据
- 故障恢复弱:本地存储无备份机制,系统崩溃可能导致调度丢失
- 精度约束:作为本地引擎,无分布式时钟同步,长时间运行可能累积漂移
- 扩展性边界:仅支持四种基础调度类型,复杂规则(如"每月最后一个工作日")可能无法表达
适合人群
- 注重数据隐私、拒绝云服务的用户
- 需要简单重复提醒但不想配置系统级 crontab 的开发者
- 希望将日程意图"固化"为可检视执行计划的效率管理者
常规风险
- 数据丢失:本地文件损坏或误删无法恢复,建议定期手动备份
jobs.json - 执行遗漏:若主机休眠或进程未持续运行,可能跳过预定执行点
- 权限问题:脚本执行依赖本地 Python 环境,路径或权限变更会导致调度失败