📬 OpenClaw Cron Delivery 会话感知指南

v2026.6.10 新特性：定时任务结果智能分发到正确的会话，不再串台。

📅 2026-06-24 · 阅读约 8 分钟 · 妙趣AI 出品

        🔥 一句话总结：Cron Delivery 会话感知让你的定时任务结果自动回到触发它的那个会话——老板在飞书问的，结果就回飞书；在钉钉问的，就回钉钉。
    

🤔 什么是会话感知？

在 v2026.6.10 之前，Cron 任务的结果只能发到固定的目标（比如固定的飞书群）。这意味着：

你在飞书私聊设置了定时任务，结果发到了群聊——尴尬
你在钉钉设置了任务，结果发到了飞书——串台了
多个用户设置了同名任务，结果混在一起——混乱

会话感知的核心：记住任务是从哪个会话创建的，结果自动回到那个会话。

⚙️ 配置方法

基础配置

# 创建 Cron 任务时自动绑定会话
# 系统会自动记录创建任务的 chat_id/channel

cron:
  delivery:
    mode: "announce"          # announce | webhook | none
    session_aware: true      # 开启会话感知
    fallback_channel: "feishu"  # 找不到原会话时的兜底
    

分发模式详解

模式	行为	适用场景
`announce`	结果自动发回原会话	大多数场景（默认推荐）
`webhook`	结果 POST 到指定 URL	集成外部系统
`none`	不发送结果	只看日志的后台任务

指定特定目标

# 如果需要覆盖默认的会话感知，手动指定目标
delivery:
  mode: "announce"
  channel: "feishu"           # 指定渠道
  to: "oc_c942dfd09730..."    # 指定群聊/用户
  threadId: "omt_xxx"         # 指定话题/线程
    

🎯 使用场景

场景 1：飞书私聊定时任务

操作：在飞书私聊中对 Agent 说"每天早上 8 点给我发 AI 日报"

结果：每天 8 点，日报自动发到你的飞书私聊——不会发到群聊

场景 2：钉钉群定时监控

操作：在钉钉群里说"每小时检查一次竞品动态"

结果：每小时的竞品报告自动发到这个钉钉群——不会串到飞书

场景 3：跨渠道任务管理

操作：在飞书创建任务，在钉钉查看

结果：任务结果默认发回飞书（创建时的会话），但你可以在钉钉用 /cron list 查看所有任务

🔧 高级用法

会话失效处理

# 当原会话失效时（群被解散、用户退出等）
delivery:
  session_aware: true
  on_session_lost: "fallback"   # fallback | skip | alert
  fallback_channel: "feishu"
  fallback_to: "ou_xxx"        # 兜底发给谁
    

多目标分发

# 同一个任务结果发给多个目标
delivery:
  mode: "announce"
  session_aware: true
  extra_targets:
    - channel: "dingtalk"
      to: "chat_id_xxx"
    - channel: "wecom"
      to: "group_xxx"
    

💡 最佳实践

✅ 推荐做法：

始终开启 session_aware: true（默认行为）
设置 fallback_channel，确保会话失效时结果不丢失
重要任务设置 on_session_lost: "alert"，及时知道会话失效
使用 /cron list 定期检查任务的会话绑定状态

⚠️ 注意事项：

会话感知基于 chat_id，如果用户换了设备但用同一账号，会话不变
webhook 模式不支持会话感知——它总是发到固定的 URL
跨渠道创建的任务，结果只回原渠道，不会自动同步到其他渠道