Quick Reminders

⏰ 零 token 轻量提醒,像朋友一样准时 nudge 你

通过 nohup + openclaw 实现的零 token 轻量提醒工具,<48小时场景免调度、免 LLM,消息自然拟人

收藏
17.7k
安装
4.3k
版本
1.1.3
CLS 安全性认证2026-07-01
点击查看完整报告 >

使用说明

核心用法

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 |
| 消息歧义 | 拟人化撰写若过度随意,用户数小时后可能误解语境 |

安全解读

核心用法

quick-reminders 是一款基于 Shell 脚本的轻量级定时提醒工具,专为 48小时内 的一次性提醒场景设计。其核心机制是通过 nohup sleep 创建后台进程,在指定时间触发后调用 openclaw message send 发送消息——创建时由 Agent 撰写文案,触发时零 LLM Token 消耗

使用流程简洁:通过 {baseDir}/scripts/nohup-reminder.sh 执行 add/list/remove 操作,支持相对时间(30s2h1d)和绝对 ISO-8601 时间,默认 Telegram 渠道,可切换至 WhatsApp、Discord、Signal、iMessage 等。

关键限制:≥2天的提醒必须转用日历,避免进程长期挂起。

显著优点

  • 零后续成本:文案一次性撰写,触发时无 LLM 调用,高频提醒场景成本极低
  • 多通道支持:Telegram 为默认,一键切换至主流 IM 渠道
  • 人性化文案:官方强制要求"朋友口吻",禁止机械表达,提升用户体验
  • 依赖极简:仅依赖系统级 jqopenclaw,无第三方包供应链风险
  • T2 可信来源:OpenClaw 生态官方维护,安全认证 Grade A(85分)

潜在缺点与局限性

  • 48小时天花板:超过 2 天的提醒需转日历,不适合长期规划
  • 进程级可靠性:依赖 nohup 后台进程,系统重启或异常退出会导致提醒丢失
  • 无持久化保障REMINDERS_JSON 路径可自定义但缺乏路径遍历防护(低风险)
  • 发送失败静默openclaw message send 错误被 || true 忽略,无重试机制
  • 无原生重复提醒:纯一次性设计,周期性任务需外部调度

适合人群

  • 高频短周期任务管理者(会议、取快递、服药、短时专注番茄钟)
  • 注重 LLM Token 成本的自动化用户
  • OpenClaw 生态深度使用者,已有 openclaw CLI 配置
  • 偏好命令行/脚本化工作流的开发者与高级用户

常规风险

| 风险维度 | 等级 | 说明 |
|---------|------|------|
| 代码安全 | 低 | 无危险函数调用,无敏感信息硬编码,六维检测全通过 |
| 系统调用 | 低 | `nohup`/`kill` 为功能必需,PID 已校验,无权限提升 |
| 数据隐私 | 低 | 仅访问功能必需环境变量,符合 GDPR 数据最小化 |
| 供应链 | 极低 | 无第三方依赖,仅系统工具 |
| 可用性 | 中 | 进程级实现存在重启丢失风险,建议关键提醒交叉验证 |

总结quick-reminders 是短周期、低成本、人性化提醒场景的最优解之一,但不适合关键业务或超 48 小时规划。

Quick Reminders 内容

scripts文件夹
手动下载zip · 7.8 kB
nohup-reminder.shtext/x-shellscript
请选择文件