后台定时提醒

技能简介

Timer 是一个后台定时工具，支持秒、分、小时等多种时间格式，到期后通过系统消息推送提醒。适用于烹饪计时、工作休息间隔、会议提醒等场景。

能做什么

• 设置指定时长的后台倒计时（支持 30s、5m、1h 等格式）
• 为每个定时器添加自定义提醒标签
• 同时运行多个独立定时器，互不干扰
• 列出、查询、取消正在运行的定时任务
• macOS 环境下播放提示音（需 afplay）

使用说明

安装要求：需预先安装 Node.js 运行时环境。

基础用法：

1. 设置 5 分钟定时器：bash background:true command:"node {baseDir}/timer.js 5m"
2. 设置带标签的定时器：bash background:true command:"node {baseDir}/timer.js 10m 'Check the oven'"
3. 查看运行中的定时器：process action:list
4. 取消指定定时器：process action:kill sessionId:XXX

关键注意事项：定时器完成后，系统会推送 System: 消息。此时必须直接回复提醒内容（如”⏰ Timer Alert! Your timer is complete: Check the pasta!”），禁止以 HEARTBEAT_OK 开头，否则消息会被过滤，用户无法收到提醒。

输入与输出

见下方输入与输出表格。

风险提示

• 若回复以 HEARTBEAT_OK 开头且少于 300 字符，消息将被系统自动拦截
• 定时器依赖后台进程，主机重启或进程异常退出会导致定时失效
• macOS 提示音功能需要 afplay 命令可用
• 长时间定时器（小时级）建议配合系统日历使用，避免进程管理开销

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/hisxo/timer/SKILL.md
来源类型：GitHub 仓库