名称： timer
描述： 设置定时器和闹钟。当后台定时器完成时，您将收到一条系统通知——请务必使用提醒消息（而非 HEARTBEAT_OK）进行回复，以通知用户。
元数据： {"clawdbot":{"emoji":"⏱️","requires":{"bins":["node"]}}}

定时器

设置可在后台运行的定时器。当定时器完成时，您将收到一条系统通知，并且必须使用提醒消息回复以通知用户。

快速开始

# 设置一个 5 分钟的定时器
bash background:true command:"node {baseDir}/timer.js 5m"

# 设置一个带标签的定时器
bash background:true command:"node {baseDir}/timer.js 10m '检查烤箱'"

# 设置一个以秒为单位的定时器
bash background:true command:"node {baseDir}/timer.js 30s"

# 设置一个以小时为单位的定时器
bash background:true command:"node {baseDir}/timer.js 1h"

时间格式

⚠️ 关键：定时器完成通知

当定时器完成时，您会收到一条 System: 消息，例如：

System: [2026-01-24 21:27:13] Exec completed (swift-me, code 0) :: ⏰ Timer complete! Check the pasta!

❌ 错误 - 请勿这样回复：

HEARTBEAT_OK

🎉 Your timer is complete! Check the pasta!

这种回复将被过滤掉，不会送达给用户！

✅ 正确 - 请这样回复：

⏰ Timer Alert! Your timer is complete: Check the pasta!

请直接以通知消息开头。不要包含 HEARTBEAT_OK。

原因： 以 HEARTBEAT_OK 开头且字符数少于 300 的回复会被自动抑制，永远不会送达用户。您的定时器通知将会丢失！

示例

烹饪定时器

bash background:true command:"node {baseDir}/timer.js 12m 'Pasta is ready!'"

完成时回复："⏰ Your 12-minute timer is up! Pasta is ready!"

快速提醒

bash background:true command:"node {baseDir}/timer.js 2m 'Take a break'"

番茄工作法

# 工作时段
bash background:true command:"node {baseDir}/timer.js 25m 'Pomodoro done - time for a break!'"
# 用户收到通知后...
# 休息时段
bash background:true command:"node {baseDir}/timer.js 5m 'Break over - back to work!'"

多个定时器

bash background:true command:"node {baseDir}/timer.js 5m 'Tea is ready'"
bash background:true command:"node {baseDir}/timer.js 10m 'Eggs are done'"
bash background:true command:"node {baseDir}/timer.js 30m 'Meeting starts soon'"

管理定时器

# 列出所有正在运行的定时器
process action:list

# 检查特定定时器状态
process action:poll sessionId:XXX

# 查看定时器输出日志
process action:log sessionId:XXX

# 取消定时器
process action:kill sessionId:XXX

注意事项

• 定时器作为具有唯一 sessionId 的后台进程运行。
• 完成的定时器以代码 0 退出。
• 取消的定时器（通过 kill）以代码 130 退出。
• 在 macOS 上，定时器完成时会播放声音通知（如果 afplay 可用）。
• 进度每秒（短定时器）或每 10 秒（长定时器）记录一次。