核心用法
quick-reminders 是一个轻量级一次性提醒技能，专为 48 小时内 的短时提醒场景设计。通过后台 nohup 进程定时触发，推送时直接调用 openclaw message send，无需消耗任何 LLM token。
核心命令：
add "消息" --target <ID> -t <时间>— 创建提醒（支持相对时间如30m、2h，或绝对 ISO-8601）list— 查看待触发提醒（自动清理已触发项）remove ID/remove --all— 删除指定或全部提醒
关键设计： 消息内容由 Agent 在创建时一次性生成，需拟人化、无上下文依赖。禁止机器人式措辞（如 "Reminder:..."），要求像朋友发短信—— casual、带同理心、一句说完。
---
显著优点
- 零运行时成本：触发阶段纯 shell 脚本执行，不调用 LLM
- 极低延迟：
nohup+ 后台轮询，无外部服务依赖 - 多通道支持：Telegram（默认）、WhatsApp、Discord、Signal、iMessage
- 人性化 UX：消息预生成策略确保用户体验一致，避免"机械感"
- 自包含：仅需
jq，依赖极简
---
潜在缺点与局限性
| 限制 | 说明 |
|------|------|
| **48 小时硬性上限** | 超长提醒被强制转交日历系统，无法统一纳管 |
| **无重复/周期提醒** | 纯一次性，不支持每日/每周循环 |
| **时区处理风险** | 绝对时间若无 `-z` 参数，依赖系统本地时区，跨时区用户易出错 |
| **目标 ID 管理负担** | `--target` 需手动从 TOOLS.md 或 `session_status` 提取，无自动发现 |
| **无富媒体** | 仅纯文本，不支持图片/按钮/链接预览 |
| **修改成本** | 规则强制 "remove → add" 两步操作，无法原地编辑 |
---
适合人群
- 需要 高频、短时、一次性 提醒的个人用户（"20 分钟后取 laundry"）
- 对 LLM 调用成本敏感 的场景（批量提醒、嵌入式设备）
- 偏好 IM 原生体验、反感系统通知栏干扰的用户
---
常规风险
1. 时区漂移：绝对时间未显式指定 -z 时，系统时区变更或容器漂移导致提前/延后触发
2. 目标 ID 失效：用户更换 Telegram 账号、WhatsApp 号码，导致消息投递失败（脚本层面无重试/通知机制）
3. nohup 进程泄漏：极端情况下（系统重启、kill -9），未触发提醒丢失且无感知
4. 消息歧义：Agent 生成的"拟人化"文本若过于随意，用户事后可能无法识别原始意图（如 "So..." 开头过于模糊）
缓解建议： 对关键提醒，建议用户二次确认时间表述；生产环境应监控 nohup-reminder.sh 进程存活。