Skip to content

定时任务(Cron)

在聊天中管理定时或一次性任务,定时发消息给 AI Agent 执行:

/cron add "standup" every:24h "总结昨天的工作"
/cron add "check" */30 * * * * "检查新的 PR"
/cron add "reminder" at:2026-04-01T09:00:00 "今天下午 Sprint 评审"
/cron list
/cron enable <id>
/cron disable <id>
/cron delete <id>

调度格式

格式示例说明
every:<时长>every:5mevery:24h固定间隔
Cron 表达式*/30 * * * *0 9 * * 1-5标准 5 字段 cron
at:<时间>at:2026-04-01T09:00:00一次性(执行后自动禁用)

命令

命令说明
/cron add "<名称>" <调度> "<消息>"创建定时任务
/cron list列出所有定时任务
/cron enable <id>启用已禁用的任务
/cron disable <id>禁用任务(不删除)
/cron delete <id>永久删除任务

持久化

任务持久化到 ~/.ringclaw/cron/jobs.json,重启不丢失。每个任务可选指定目标 Agent 或 Chat。

安全注意事项

  • /cron add 是特权命令,与 /cwd/new 适用同一套 owner 门控。 允许范围见 安全 › 第一层
  • Cron 触发的 Agent 回复不会执行 ACTION: 块。 调度器把回复原样 发回聊天——如果 Agent 输出含 ACTION: NOTE/TASK/EVENT/CARD/MESSAGE, 它会以纯文本形式进入聊天,不会调用 RC API 执行。这是刻意设计:定时 任务没有人类 sender,第二层的跨聊天门控无法判断是否为 owner。如果 希望定时任务真的创建 task/note,可以在 prompt 里让 Agent 返回 /task create ... 这类可人工触发的命令,并在信任群聊中运行。