心跳检查与定时任务配置

2025-07-10 · 3 分钟进阶玩法

让龙虾主动找你

OpenClaw 最让用户惊喜的功能之一就是心跳检查（Heartbeat）——AI 会按照设定的间隔主动发消息给你，汇报状态、提醒事项或者只是问候一声。很多用户说这是 OpenClaw 从"工具"变成"伙伴"的关键体验。

心跳配置

{
  agents: {
    defaults: {
      heartbeat: {
        enabled: true,
        intervalMinutes: 120,     // 每 2 小时检查一次
        quietHoursStart: "23:00", // 晚 11 点后不打扰
        quietHoursEnd: "08:00"    // 早 8 点前不打扰
      }
    }
  }
}

心跳触发时，AI 会根据上下文自主决定是否发送消息。如果没什么值得汇报的，它会安静跳过。

常见心跳行为

根据社区用户反馈，龙虾在心跳时可能会：

提醒你今天有未完成的日程
汇报后台任务的执行进度
发现你的邮箱有重要未读邮件
提醒你该起来活动一下了
根据天气变化提醒你带伞

Cron 定时任务

除了心跳，你还可以设置精确的定时任务：

{
  agents: {
    defaults: {
      cron: [
        {
          schedule: "0 8 * * *",         // 每天早上 8 点
          task: "发送今日天气和日程简报"
        },
        {
          schedule: "0 18 * * 5",        // 每周五下午 6 点
          task: "生成本周工作总结"
        },
        {
          schedule: "*/30 9-18 * * 1-5", // 工作日每 30 分钟
          task: "检查是否有新的重要邮件"
        }
      ]
    }
  }
}

Cron 表达式格式：分时日月星期

实用定时任务示例

任务	Cron 表达式	说明
早间简报	`0 8 * * *`	每天早 8 点
股票收盘汇总	`0 15 * * 1-5`	工作日下午 3 点
周报生成	`0 17 * * 5`	每周五下午 5 点
服务器健康检查	`0 /6 * *`	每 6 小时
生日提醒	`0 9 * * *`	每天检查通讯录

管理定时任务

# 查看所有定时任务
openclaw cron list

# 手动触发一个任务
openclaw cron trigger "早间简报"

# 查看任务执行历史
openclaw cron history

注意事项

心跳和 Cron 任务需要网关持续运行（建议安装守护进程）
设置安静时段避免深夜打扰
Cron 任务描述用自然语言即可，AI 会自行理解并执行