channel-reminders

核心用法

Channel Reminders 是一个纯文档型 Skill，用于指导用户在 OpenClaw 多 Agent 架构中配置 Telegram 定时提醒功能。该 Skill 本身不提供可执行代码，而是通过详细的配置文档说明如何利用系统内置的 cron 调度机制和 heartbeat 功能实现消息推送。

主要使用场景分为两类：一是 Main Agent 直接接收 systemEvent 并回复用户；二是非 Main Agent（如 Semen、Andrey 等）通过 Main Agent 中转，利用 message tool 发送消息。配置核心包括三个要素：启用 heartbeat（heartbeat.every 不能为 "0m"）、在 HEARTBEAT.md 中添加提醒处理指令、以及设置 wakeMode: "now" 确保即时触发。

显著优点

1. 架构清晰：充分利用 OpenClaw 的 session 和 heartbeat 机制，避免重复造轮子
2. 多 Agent 支持：通过 Main Agent 中转方案，解决了非 Main Agent 无法直接触发 heartbeat 的限制
3. 配置灵活：支持一次性（at）、周期性（cron）和间隔（every）三种调度方式
4. 文档详尽：包含完整的测试流程、故障排查清单和多种使用示例
5. 零依赖：纯文档型 Skill，无需安装运行时或外部库

潜在缺点与局限性

1. 配置门槛高：需要理解 OpenClaw 的 heartbeat、session、systemEvent 等内部概念
2. 依赖系统配置：若用户未正确配置 openclaw.json 或 HEARTBEAT.md，功能完全失效
3. 时区易错：文档多次强调必须指定时区，否则默认 UTC 可能导致提醒时间错误
4. 仅支持 Telegram：消息推送渠道单一，未覆盖其他 IM 平台
5. 调试复杂：涉及多个组件（cron、heartbeat、message tool）协同，问题定位困难

适合的目标群体

• 已部署 OpenClaw 多 Agent 架构的高级用户
• 需要通过 Telegram 接收自动化提醒的开发者或运营人员
• 熟悉 JSON 配置和 cron 表达式、具备一定技术背景的用户
• 愿意投入时间理解系统机制、进行配置测试的耐心用户

使用风险

1. 配置失效风险：任何环节配置错误（heartbeat 关闭、HEARTBEAT.md 缺失、wakeMode 遗漏）都会导致提醒静默失败
2. 时区混乱风险：未指定时区的定时任务将以 UTC 执行，可能造成数小时偏差
3. Token 泄露风险：用户需自行管理 Telegram Bot Token，不当存储可能导致安全风险
4. 多 Agent 协调风险：非 Main Agent 方案依赖 Main Agent 的可用性，存在单点故障
5. 维护负担：系统升级后 HEARTBEAT.md 可能被覆盖，需要持续维护配置