Casual Cron

核心用法

Casual Cron 允许用户通过自然语言创建定时任务（cron jobs），无需手动编写复杂的 cron 表达式。支持两种触发方式识别：直接的自然语言描述（如"每天下午 3 点提醒我"）或快捷命令 /at、/every。

关键流程：
1. 识别用户调度意图
2. 解析时间、频率、渠道、目标、消息内容
5. 构建 openclaw cron add CLI 命令
4. 执行前强制确认 parsed time、job name、job id

两种任务类型：

• /at 一次性任务：支持绝对时间（DST-aware 时区转换）或相对时间（如 20m）
• /every 循环任务：支持 interval（如 2h）或 cron 表达式

安全运行保护（Hard Rules）：

• 在 cron job 内部运行时：禁止排错、禁止重启网关、禁止检查时间
• 禁止发送确认消息或解释
• 仅输出精确的消息 payload 后立即停止

显著优点

• 自然语言解析：覆盖常见时间格式（8am、noon、midnight、14:30 等）和频率模式（daily、weekdays、hourly、weekly 等）
• 多渠道投递：原生支持 Telegram、WhatsApp、Slack、Discord、Signal
• DST 安全：America/New_York 时区自动处理夏令时转换
• 隔离会话：--session isolated 防止任务间状态污染
• 自清理机制：一次性任务自动 --delete-after-run
• 快捷命令：/at 和 /every 降低使用门槛

潜在缺点与局限性

• 时区硬编码：默认 America/New_York，其他地区需显式指定
• 渠道环境依赖：需预配置 CRON_DEFAULT_CHANNEL 或显式声明
• 确认步骤强制：无法跳过确认流程，对高级用户可能冗余
• Telegram 优先设计：文档示例以 Telegram 为主，其他渠道覆盖较弱
• 无持久化可见性：未提及任务列表查询、修改、删除的管理接口
• 递归风险：虽有 run-guard，但依赖实现层面的严格遵守

适合人群

• 需要个人提醒/通知自动化的终端用户
• 习惯 Telegram 等即时通讯工具作为消息枢纽的用户
• 不熟悉 cron 表达式但需定时任务的非技术用户
• Clawdbot/OpenClaw 生态的现有用户

常规风险

| 风险类别 | 说明 |

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

| 无限递归 | 若 run-guard 被绕过，任务可能触发自身导致级联执行 |

| 时区错误 | 跨时区用户可能因默认 America/New_York 收到错误时间提醒 |

| 消息泄露 | `--message` 内容若包含敏感信息，需确保渠道和目标 ID 正确 |

| 任务堆积 | 未完成的循环任务可能持续运行，需手动清理机制 |

| 确认劫持 | 社会工程学攻击可能诱导用户确认恶意构造的任务 |

核心用法

Casual-cron 是一款面向 Clawdbot 的自然语言定时任务调度工具，用户可通过口语化指令（如"每天下午 3 点提醒我喝水"或"/every 2h"）快速创建 cron 作业。该 skill 将自然语言解析为精确的 CLI 命令，支持两种调度模式：

• 一次性任务（/at）：支持绝对时间（如"3pm"，自动处理 DST）或相对时间（如"20m"）
• 重复任务（/every）：支持间隔频率（"2h"）或标准 cron 表达式（"0 15 *"）

系统内置严格的运行防护规则：当处于 cron 作业执行环境时，禁止故障排查、网关重启、时间检查及任何确认消息，仅输出精确的消息负载，防止递归调用和资源浪费。

显著优点

1. 零依赖安全架构：纯 Python 标准库实现（json, os, re, sys, unittest），无第三方包，供应链攻击面为零
2. DST 感知时区处理：默认 America/New_York 时区，自动处理夏令时转换
3. 多通道交付：原生支持 Telegram、WhatsApp、Slack、Discord、Signal
4. 隔离会话模式：使用 --session isolated 确保任务执行环境干净
5. 自清理机制：一次性任务自动附加 --delete-after-run，避免 cron 表膨胀

潜在缺点与局限性

• T3 来源可信度：个人开发者/社区项目，虽代码审计优秀但缺乏企业级维护背书
• 功能单一性：专注于 Clawdbot 生态，无法直接迁移至其他 cron 系统
• 时区硬编码：默认时区为美国东部，非北美用户需显式覆盖
• 输入验证有限：电话号码和句柄提取依赖正则，复杂注入场景防护不足
• 无 Web UI：纯 CLI 驱动，对非技术用户存在学习曲线

适合人群

• Clawdbot/Telegram 重度用户，需要自动化提醒和工作流
• 开发者寻求轻量级、可审计的定时任务方案
• 隐私敏感用户（无网络通信、无数据持久化）

常规风险

• 误删除风险：--delete-after-run 可能导致重要一次性任务记录丢失
• 权限配置错误：若 CRON_DEFAULT_CHANNEL 环境变量配置不当，消息可能发送至错误通道
• 时间解析歧义：自然语言理解存在边缘 case（如"next monday"在不同语境下的歧义）
• 会话隔离限制：isolated 模式无法访问用户历史上下文，某些复杂任务受限