核心用法
quick-reminders 是一个为短期场景(<48 小时)设计的零 LLM 提醒系统。创建时由 Agent 一次性撰写最终送达文本,随后交由 nohup sleep 后台进程托管,触发时通过 openclaw message send 直接投递,全程不消耗 LLM token。
命令集:
add "文本" --target <ID> -t <时间>创建提醒(支持相对时间30s/20m/2h/1d或 ISO-8601 绝对时间)list查看并自动清理已触发条目remove ID [...]/remove --all删除单条或全部
渠道支持: Telegram(默认)、WhatsApp、Discord、Signal、iMessage 等,通过 --channel 切换。
---
显著优点
- 零运行时成本:触发阶段无 LLM 调用,纯 shell 后台进程,资源占用极低
- 极速响应:本地
nohup调度,无外部服务依赖,延迟可控在秒级 - 消息人格化:强制要求撰写"朋友口吻"文本("Hey, you wanted to..."),拒绝机器人腔调
- 多通道灵活:同一脚本适配 IM 多平台,只需更换
--target和--channel
---
潜在局限
- 48 小时硬 ceiling:超长周期需转日历系统,否则进程可能被系统回收或睡眠精度漂移
- 单机脆弱性:依赖本地
nohup进程,终端重启/系统休眠可能导致丢失 - 时区敏感:绝对时间需显式
-z指定,否则 fallback 到系统本地,跨时区场景易出错 - 无重复周期:纯 one-shot,不支持每日/每周循环提醒
---
适合人群
- 高频临时备忘用户("20 分钟后收衣服"类场景)
- 对 LLM 调用成本敏感、追求极致轻量的极简主义者
- 已有 openclaw 生态、希望统一 IM 投递渠道的技术用户
---
常规风险
| 风险点 | 说明 |
|--------|------|
| 进程丢失 | 系统重启/终端会话结束导致 `nohup` 后台被清理 |
| 时间漂移 | 长 sleep(接近 48h)受系统时钟调整影响 |
| 渠道 ID 泄露 | `--target` 可能携带敏感手机号/Chat ID,需确保脚本权限 600 |
| 消息歧义 | 拟人化撰写若过度随意,用户数小时后可能误解语境 |