Cron

核心用法

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 环境，路径或权限变更会导致调度失败

核心用法

Cron skill 是一套本地优先的循环任务管理系统，将用户关于"每周三提醒""每月1号执行"等自然语言意图，转化为结构化的本地日程契约。通过 Python 脚本实现完整的任务生命周期管理：

| 脚本 | 功能 |

|------|------|

| `add_job.py` | 创建定时任务（daily/weekly/monthly/interval） |

| `next_run.py` | 预览即将执行的任务 |

| `pause_job.py` / `resume_job.py` | 暂停与恢复调度 |

| `show_job.py` / `list_jobs.py` | 查看单个或全部任务状态 |

任务状态分三级流转：active（运行中）→ paused（暂停）→ archived（归档），用户始终掌握执行预期。

显著优点

• 零外部依赖：仅使用 Python 标准库，无供应链攻击面
• 数据主权：所有数据本地 JSON 存储，不上云、不同步、不泄露
• 原子写入：采用 .tmp + os.replace() 模式防止数据损坏
• 调度透明：next_run.py 让用户明确知道"什么任务何时运行"

潜在局限

• 无分布式能力：纯单机运行，无法跨设备同步任务状态
• 无持久化守护进程：依赖外部触发执行，非常驻服务
• T3 来源风险：本地开发项目，无公开代码仓库验证，信任建立于代码审计而非社区背书

适合人群

• 注重隐私、拒绝云同步的本地优先用户
• 需要轻量级循环提醒但不想部署复杂系统的个人工作者
• 对定时任务有"可见即可控"强需求的项目管理者

常规风险

| 风险类型 | 等级 | 说明 |

|----------|------|------|

| 数据丢失 | 低 | 仅本地存储，建议用户自行备份 `~/.openclaw/workspace/memory/cron/` |

| 代码注入 | 极低 | 无 eval/exec，参数经 argparse 校验 |

| 供应链攻击 | 无 | 零第三方包 |

| 隐私泄露 | 无 | 零网络通信，数据不出本机 |