Channel Reminders

核心用法

Channel Reminders 是一个基于 cron jobs 的 Telegram 定时提醒系统，允许用户通过多种调度方式（一次性、周期性、间隔触发）在指定时间向目标聊天发送消息。

主要功能

1. 调度类型

• at: 一次性定时提醒，需指定完整 ISO 时间含时区
• cron: 周期性任务，支持标准 cron 表达式（如 0 9 * * 1-5 工作日 9 点）
• every: 间隔触发，以毫秒计（如 3600000ms = 1 小时）

2. 代理路由架构

• Main 代理直投: 通过 sessionTarget: "main" + systemEvent 直接由主代理处理并回复
• 非 Main 代理中转: 通过 agentId: "main" 将 systemEvent 路由至主代理，由其解析并调用 message tool 以指定代理身份发送

3. 关键配置要求

• heartbeat.every 不能为 "0m" 或缺失（建议 5m）
• wakeMode: "now" 确保即时触发，避免等待下次 heartbeat
• HEARTBEAT.md 必须包含 systemEvent 处理指令

显著优点

• 多代理身份支持: 允许 Semen、Andrey、Hristofor、Discussions 等非主代理以自己的身份发送提醒
• 灵活调度: 覆盖一次性、周期性、高频间隔等多种场景
• 即时投递: wakeMode: "now" 消除延迟
• 结构化路由: 通过 accountId + target 精准控制发送方和接收方

潜在缺点与局限性

• 配置复杂度高: 需要同时维护 openclaw.json、HEARTBEAT.md、MEMORY.md 三处配置
• 依赖主代理可用性: 非主代理的提醒完全依赖 main agent 的 heartbeat 和正确解析
• 时区敏感: 时间字符串必须显式带时区，否则默认 UTC 易出错
• 调试门槛: 失败时需检查 heartbeat 配置、HEARTBEAT.md 指令、cron 语法、Chat ID 四重因素
• 无原生持久化: 依赖外部 cron list 管理，无内置任务持久化保障

适合人群

• 已部署 OpenClaw 多代理架构的高级用户
• 需要以不同机器人身份发送提醒的场景（客服、财务、个人助手分离）
• 熟悉 cron 表达式和 JSON 配置的技术用户

常规风险

| 风险类型 | 描述 | 缓解措施 |

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

| 配置遗漏 | heartbeat 关闭或 HEARTBEAT.md 缺失指令 | 安装后强制执行 4 步测试流程 |

| 身份混淆 | accountId 错误导致消息发送方不符 | 建立 MEMORY.md 对照表 |

| 时区错误 | 未指定 tz 导致 UTC 偏差 | 强制使用 `+03:00` 格式 |

| 延迟投递 | 遗漏 `wakeMode: "now"` | 模板化配置，强制字段校验 |

| 权限泄露 | Chat ID 暴露于配置文件中 | 限制文件权限，避免版本控制 |

测试验证流程

文档强制要求安装后执行 4 步验证：简单提醒测试、message tool 测试、记录工作模式至 MEMORY.md、故障排查检查清单，体现了工程化严谨性。