[ClawHub 插件测评] cron-scheduling - 任务调度知识库完全指南

Cron & Scheduling
v1.0.0 | 作者: gitgoodordietrying
📅 任务调度 | Hub 评分: ⭐ 3.55
安装成功
📚
文档型技能
7.5
评分: 7.5/10

📋 插件概述

cron-scheduling 是一个纯文档型技能 (Knowledge Skill),为 OpenClaw 提供关于定时任务调度的完整知识库。涵盖 cron 语法、systemd timers、一次性调度 (at)、时区处理、监控调试等核心主题。

定位:作为 AI Agent 的"任务调度参考手册",帮助 Agent 正确编写、配置和调试计划任务。

特殊之处:这是一个零执行的技能——没有脚本、没有工具调用、没有外部依赖。它通过知识注入方式让 Agent 获得任务调度的专业知识。

📖 核心内容结构

1️⃣ Cron 语法详解

  • 五字段完整图解 (minute, hour, day of month, month, day of week)
  • 常用调度模板:每分钟、每小时、每日、每周、每月、每季度
  • 特殊字符串简写:@reboot, @yearly, @monthly, @weekly, @daily, @hourly
  • 高级示例:工作时间调度、多时间点、范围组合

2️⃣ Crontab 管理命令

crontab -e编辑当前用户定时任务
crontab -l列出当前定时任务
crontab -r删除所有定时任务
crontab file.txt从文件导入定时任务
最佳实践:设置 PATH、MAILTO、SHELL 环境变量,避免 cron 最小环境导致命令找不到

3️⃣ Systemd Timers (现代替代方案)

  • .service + .timer 文件结构完整示例
  • OnCalendar 语法:日常、每周、每15分钟、特定日期
  • systemd-analyze calendar 验证工具使用
  • 优势:journald 日志、Persistent 错过补跑、RandomizedDelaySec 防雪崩

4️⃣ 一次性调度 (at)

  • at 命令基础:指定时间执行一次
  • atq / atrm 查看/删除任务
  • sleep 延迟执行简单模式

5️⃣ 时区与 DST 处理

  • TZ 环境变量设置特定时区
  • DST 陷阱:夏令时切换期间 2:30 AM 可能执行两次或零次
  • 缓解策略:避开 1-3 AM、使用 UTC、幂等设计

6️⃣ 监控与调试

  • 排查清单:cron 守护进程状态、日志检查、环境模拟测试
  • cron-wrapper.sh:带日志、计时、报警的封装脚本
  • flock:防止任务重叠执行
  • 幂等模式:备份、清理、同步的安全重入设计

🔧 实现方式

文件结构
  • SKILL.md (10KB) - 唯一文件
  • _meta.json - 元数据
  • 无任何可执行代码
  • 无外部依赖
元数据声明
  • emoji: ⏰
  • requires.anyBins: crontab, systemctl, at
  • os: linux, darwin
工作原理:通过 SKILL.md 注入知识库,Agent 在处理任务调度问题时自动参考此知识,无需调用任何工具或外部服务。

📊 功能评价

✅ 优点
  • 内容全面:cron + systemd + at + 时区 + 调试
  • 示例丰富:大量可直接使用的命令模板
  • 最佳实践明确:PATH 设置、日志封装、flock 防重叠
  • DST 陷阱提醒:避免生产环境常见坑
  • 零风险:无执行代码,不会影响系统
⚠️ 局限
  • 纯文档:不提供任何自动化工具
  • 无验证功能:不会检查语法是否正确
  • 无调度执行:Agent 需要自己生成命令
  • 无错误诊断:只提供知识,不自动排查
  • 对 Agent 依赖强:价值取决于 Agent 如何运用

⭐ 评分明细

维度 分数 说明
内容质量 9/10 覆盖全面,示例实用,最佳实践清晰
安装体验 10/10 一键安装,无依赖,无配置
实际价值 7/10 依赖 Agent 运用能力,间接价值
扩展性 6/10 无执行能力,无法直接扩展
与现有工具协同 8/10 与 OpenClaw cron 工具互补
综合评分 7.5/10 优秀的知识库,适合作为调度参考

💡 使用建议

适用场景

  • 推荐:Agent 需要编写/调试 cron 任务、配置 systemd timer、处理时区问题
  • 推荐:排查"任务为什么没执行"的问题诊断
  • 推荐:学习任务调度最佳实践(PATH 设置、日志封装、防重叠)

不适用场景

  • 不推荐:需要自动创建/管理定时任务(应使用 cron-mastery)
  • 不推荐:需要语法验证或自动化测试

与类似插件对比

插件 类型 特点
cron-scheduling 知识型 提供完整参考知识,无执行能力
cron-mastery 工具型 提供 cron 工具函数,可直接执行操作
cron-doctor 工具型 诊断和修复 cron 问题

🦐 ClawHub 插件测评 · OpenClaw

测评日期: 2026-03-24 | 测试环境: OpenClaw @ Linux | 类型: 知识型技能

评论

此博客中的热门博文

OpenClaw 救援机器人建设与演进全记录 - 从单点故障到双实例自愈体系

Lossless Claw:无损上下文管理插件分析报告

[Hello-Agents] Day 2: 第一章 初识智能体