Quick Reminders

核心用法

quick-reminders 是一个轻量级一次性提醒技能，适用于48小时内的短期提醒。通过 nohup sleep 创建后台进程，在指定时间通过 openclaw message send 发送消息。

工作流程：
1. Agent在创建时撰写最终发送文本（人性化、口语化）
2. 调用 nohup-reminder.sh add 设置时间和目标
3. 后台进程到期自动触发，零LLM token消耗

关键命令：

• add "文本" --target <ID> -t <时间> — 创建提醒（支持相对时间如30m、2h，或绝对ISO-8601）
• list — 查看待办（自动清理已触发）
• remove ID / remove --all — 删除提醒

多通道支持： Telegram（默认）、WhatsApp、Discord、Signal、iMessage，通过 --channel 切换。

显著优点

1. 零运行时成本 — 创建时一次性撰写文本，触发时无LLM调用，适合高频短周期提醒场景
2. 人性化表达 — 强制要求"朋友发短信"风格，禁止机器人式"Reminder:"开头，支持幽默共情
3. 极简架构 — 纯bash+nohup，无依赖服务，可靠性高
4. 灵活时间格式 — 同时支持自然相对时间（1h30m）和带时区的绝对时间

潜在缺点与局限性

| 限制 | 说明 |

|------|------|

| **48小时硬上限** | 超期必须使用日历，无法替代长期日程管理 |

| **无持久化保障** | 系统重启/进程被杀则提醒丢失，非关键事务适用 |

| **单设备依赖** | nohup进程绑定创建时的机器，无跨设备同步 |

| **无重复提醒** | 纯一次性，不支持周期性任务 |

| **文本冻结** | 创建后无法修改内容，只能删除重建 |

适合人群

• 需要低成本、高频率短期提醒的用户（如番茄钟、临时待办）
• 重视消息人格化体验、反感系统通知腔调的用户
• 技术用户（Agent开发者）需要轻量提醒原语构建工作流

常规风险

• 进程级可靠性：nohup在系统休眠、重启、OOM时可能失效，关键提醒建议双重确认
• 时区陷阱：绝对时间若省略-z参数，依赖系统local时间，跨时区场景易出错
• 目标ID管理：--target需从TOOLS.md或session_status提取，配置缺失时命令失败
• 无送达确认：openclaw发送失败（如网络中断）无重试机制，用户可能错过提醒

核心用法

quick-reminders 是一款轻量级的一次性提醒 Skill，专为 48 小时内的短期提醒场景设计。用户通过自然语言指令（如"2小时后叫我拿快递"）触发，Agent 在创建时刻即完成消息文案的拟人化撰写，随后交由 nohup sleep 后台进程在指定时间通过 openclaw message send 静默投递——全程零 LLM 令牌消耗。

关键路径：

• 创建：nohup-reminder.sh add "文案" --target <ID> -t <时间>
• 查询：nohup-reminder.sh list（自动清理已触发条目）
• 删除：nohup-reminder.sh remove <ID> 或 --all

时间格式支持相对值（30s、2h、1d）或绝对 ISO-8601，跨时区可通过 -z 指定 IANA 时区。消息渠道默认为 Telegram，可切换至 WhatsApp、Discord、Signal、iMessage 等。

显著优点

1. 零运行时成本
提醒触发时不消耗任何 LLM 资源，适合高频轻量场景。后台进程基于原生 Unix nohup + sleep，无需持久化服务或数据库。

2. 拟人化交付体验
Skill 明确要求文案"像朋友发消息"，禁止机器人腔调（如"Reminder:""This is your reminder..."）。Agent 需主动添加情境线索（"Hey, you wanted to call John""I know you hate it, but..."），确保用户脱离上下文后仍能秒懂。

3. 防御性边界设计
内置硬性 guardrail：用户请求 ≥2 天的提醒时，自动拒绝本 Skill 并引导至日历事件，避免后台进程长期挂起和可靠性风险。

4. 安全编码规范
脚本采用 set -euo pipefail 严格模式，目录锁机制防止竞态条件，临时文件权限 0600，输入参数经正则验证（如 PID 必须匹配 ^[0-9]+$）。

潜在缺点与局限性

1. 会话级持久化
提醒进程绑定当前会话和机器状态，系统重启或会话终止后全部丢失。不适合重要事务或跨设备同步需求。

2. 48 小时天花板
硬性时限导致无法覆盖周末规划、旅行提醒等中长周期场景，必须降级到日历 Skill。

3. 单点执行风险
依赖目标机器持续运行，无分布式容错。若机器休眠或网络中断，提醒将静默失败（无重试机制）。

4. 渠道配置门槛
--target 需从 TOOLS.md 或 session_status 提取特定格式的渠道 ID（如 Telegram chat_id、WhatsApp E.164），新用户首次使用需手动确认或配置，体验非完全无缝。

适合人群

• 高频短期事务型用户：需要大量"30 分钟后回电话""今晚 6 点取干洗"类提醒，不愿被日历事件淹没。
• 成本敏感场景：LLM 调用预算受限，希望提醒功能零令牌消耗。
• 单设备常驻工作流：个人工作站或长期在线服务器环境，无频繁重启或迁移需求。

不适合：跨设备同步依赖者、关键 deadline 提醒（如合同截止）、需复杂 recurring 规则的用户。

常规风险

| 风险类别 | 说明 | 缓解措施 |

|---------|------|---------|

| 进程管理 | `bash -c` 动态构造命令、`kill` 终止进程、 `rm -f` 清理文件，理论上存在注入或误杀风险 | 参数经严格验证，PID 正则过滤，临时文件路径受控 |

| 数据残留 | reminders.json 默认权限未明确限制，可能泄露提醒元数据 | 建议手动设置 0600 权限（官方已纳入推荐改进项） |

| 依赖可用性 | 依赖 `jq` 和 `openclaw` CLI，目标环境缺失时 Skill 失效 | 运行时通过 `check_deps` 主动校验并友好报错 |

| 交付失败 | 网络中断或 openclaw 服务异常时，提醒静默丢失 | 当前无重试或状态回查机制，关键提醒建议备用方案 |

安全认证结论：CLS-Certify 评级 A 级（85 分），来源可信度 T2（可信社区项目），无恶意模式、无隐蔽外联、无权限升级诱导，建议放心使用。