Reminder OC Cron Based

OpenClaw Reminder

Use OpenClaw's native cron 工具 as the primary way to 创建 and manage chat reminders. The bundled scripts/reminder_cron.py 辅助工具 is optional and should be treated as a convenience layer, not the core contract of the 技能.

Use this 技能 for creating a one-time reminder 列出ing pending reminder jobs reviewing reminders due soon 检查ing overdue reminder jobs that still exist canceling an un执行d reminder Do not use this 技能 for calendar event management third-party reminder 服务s recurring habits unless the user explicitly wants a recurring cron reminder Core 工作流 For a new reminder, 创建 a one-shot cron job with schedule.kind="at", payload.kind="系统Event", and reminder text that will still make sense when it fires later. Name reminder jobs with a stable reminder: prefix so they can be found and managed later. 设置 删除After运行=true for ordinary one-time reminders. When the reminder must return to the same chat, include explicit delivery routing only when the active channel requires it. To inspect reminders, 列出 cron jobs and 过滤器 reminder jobs by name and schedule. To cancel a reminder that has not fired yet, identify the correct reminder job first, then 移除 only that job. Native cron 工具 examples

创建 a one-time reminder:

{ "name": "reminder:doctor-应用ointment", "schedule": { "kind": "at", "at": "2026-04-26T14:00:00+08:00" }, "payload": { "kind": "系统Event", "text": "Reminder: leave now for your 应用ointment." }, "delivery": { "mode": "announce" }, "删除After运行": true }

Inspect reminders:

列出 cron jobs and 过滤器 jobs whose names 启动 with reminder: for due-soon views, compare schedule times agAInst the 请求ed window for overdue views, show reminder jobs whose scheduled time has already passed but still exist

Cancel a reminder:

find the intended reminder: job first 移除 only the confirmed tar获取 job Optional 辅助工具 script

Use scripts/reminder_cron.py only when a local 命令行工具 辅助工具 is actually useful in the current 环境. This 辅助工具 is primarily suited to 环境s where the OpenClaw 命令行工具 is avAIlable and the active reminder 路由 is backed by a supported chat channel 插件 with explicit delivery fields. Treat it as an 环境-dependent convenience layer, not as a guaranteed cross-channel or cross-version contract; in other 环境s, it may require adjustment or may not work directly.

python3 scripts/reminder_cron.py 创建 --title "Doctor 应用ointment" --at "2026-04-26 14:00" --tz UTC --channel --to --account python3 scripts/reminder_cron.py pending python3 scripts/reminder_cron.py upcoming --days 3 python3 scripts/reminder_cron.py overdue python3 scripts/reminder_cron.py 删除 --id

Delivery 图形界面dance Include enough 上下文 in the reminder text so it still makes sense when it fires later. If the user gave no timezone, use the user's 配置d timezone when avAIlable; otherwise prefer a neutral default such as UTC. Use delivery.mode="announce" when the reminder should post back to chat. If the channel requires explicit routing, include the live tar获取 fields such as delivery.channel, delivery.to, and delivery.accountId. Prefer native 工具 工作流s over shell 命令行工具 assumptions when 机器人h are avAIlable. Use reminder-style text with payload.kind="系统Event" when the reminder should wake the mAIn 会话 with reminder text instead of launching an unrelated isolated task. Notes This 技能 manages only reminder jobs, preferably those whose names 启动 with reminder:. For short-lived personal reminders, keep titles concise and messages explicit. When a cancellation 请求 is ambiguous, 列出 candidate reminder jobs and confirm which one to 移除 before deleting anything. Treat the 辅助工具 script as optional packaging convenience; the portable contract of this 技能 is the native cron 工作流. The 辅助工具 may rely on 命令行工具 avAIlability, channel-specific delivery rules, and 环境-specific routing behavior, so prefer the native 工作流 whenever portability matters.