channel-reminders

⏰ Telegram定时提醒配置专家

OpenClaw社区开发的Telegram定时提醒配置指南,通过cron任务调度实现多Agent消息推送,需配合heartbeat机制使用。

收藏
644
安装
313
版本
v1.3.0
CLS 安全性认证2026-07-01
点击查看完整报告 >

使用说明

核心用法

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 可能被覆盖,需要持续维护配置

安全解读

Channel Reminders 技能评估

核心用法

Channel Reminders 是一个纯文档型配置指南 Skill,用于在 OpenClaw 框架中设置定时提醒并通过 Telegram 送达。该技能本身不包含任何可执行代码,而是提供完整的 JSON 配置模板、HEARTBEAT.md 集成说明以及多代理消息路由方案。

主要配置模式:
1. 主代理直接模式:主代理通过 systemEvent 接收提醒,利用 heartbeat 机制立即触发响应

2. 非主代理解耦模式:其他代理(Semen/Andrey/Hristofor/Discussions)通过主代理中转,使用 message tool 以自身身份发送消息

显著优点

  • 架构清晰:采用 cron job + heartbeat + systemEvent 的标准化事件驱动架构
  • 多代理支持:独创的 "主代理中转" 方案解决了非主代理无法直接触发 heartbeat 的限制
  • 配置灵活:支持一次性(at)、周期性(cron)、间隔(every)三种调度类型
  • 安全透明:纯 Markdown 文档,无可执行代码,所有操作均为配置示例
  • 来源可信:OpenClaw Community 官方维护,MIT 开源协议

潜在缺点与局限性

  • 配置门槛高:需要正确配置 openclaw.json heartbeat、编写 HEARTBEAT.md 处理逻辑、理解 sessionTarget/wakeMode 等概念
  • 依赖外部状态:必须提前获取用户 Chat ID 和各代理 accountId,缺乏自动化发现机制
  • 调试复杂:提醒失败时需排查 heartbeat 配置、HEARTBEAT.md 指令、cron job 参数三个层面
  • 时区易错:文档反复强调必须显式指定时区,否则默认为 UTC

适合人群

  • 多 Telegram bot 用户:需要区分工作/生活/财务等不同身份发送提醒
  • OpenClaw 进阶用户:已熟悉 agent 配置、heartbeat 机制和 tool call 用法
  • 自动化需求者:希望将提醒系统与现有 AI 工作流深度整合

常规风险

  • 配置错误风险wakeMode: "now" 遗漏会导致提醒延迟最多 5 分钟;时区遗漏导致 UTC 时间偏差
  • 权限扩散风险message tool 权限若配置不当,可能导致代理越权发送消息
  • 敏感信息泄露:Chat ID 和 Bot Token 若硬编码在共享配置中,存在暴露风险

安全认证亮点

静态扫描评分 95/100,等级 S。纯文档型技能,仅引用官方 Telegram API,无数据收集行为,隐私合规项全部通过。

channel-reminders 内容

手动下载zip · 4.3 kB
package.jsonapplication/json
请选择文件