ClawHub

群消息超时监控

Security

自动监控飞书多维表格中当日未回复且未撤回的群聊话题，超时超过30分钟则推送提醒。

Install

openclaw skills install group-message-timeout-monitor

群消息超时监控 Skill

自动监控飞书多维表格中今日未回复的群聊话题，标记已撤回的，推送超时未回的。

版本：v1.0 更新：2026-05-19

触发条件

  • 定时触发：cron 每 5 分钟执行一次（cron 任务后续单独配置）
  • 手动触发：用户说「检查群消息」「群消息超时监控」

前置条件（每次运行第一步）

1. OAuth 授权检查

尝试以用户身份调用任意 API（如 feishu_get_user），验证授权有效性：

  • 有效 → 继续
  • 失效/过期 → 提示用户重新授权，终止本次运行

2. 确认当前日期

计算今天的「发送日期」格式：

TZ=Asia/Shanghai date '+%m月%d日'
# 例如：05月19日

数据源

项目值
多维表格会话内的消息统计
数据表群聊记录同步
app_tokenJ8Rnb51vsaRqCmsb0R6cdZLonKd
table_idtblolq9Wm75jcPLt

涉及字段

字段名类型用途
发送日期Formula(Text)过滤当天记录，格式 mm月dd日
根消息IDText空=原始话题（非回复）
话题回复内容Formula(Text)空=无人回复过
发送人User排除风控值班自己发的消息
是否撤回Checkbox已勾选=已确认撤回，永久跳过
发送时间DateTime(ms)毫秒时间戳，用于计算超时
消息IDText格式 om_x100b...，用于查撤回
所在群GroupChat群ID+群名
消息链接Urlapplink，推送用
聊天记录Text消息内容，推送时展示

执行流程

阶段一：API 五层筛（一次调用）

用 feishu_bitable_app_table_record 的 list 方法，一次性传入 5 个 filter 条件。

条件顺序按筛除效率排列：越筛人的放越前面，减少后续匹配计算量。

{
  "field_names": ["消息ID", "发送时间", "所在群", "消息链接", "聊天记录"],
  "filter": {
    "conjunction": "and",
    "conditions": [
      {"field_name": "发送日期", "operator": "is", "value": ["05月19日"]},
      {"field_name": "根消息ID", "operator": "isEmpty"},
      {"field_name": "话题回复内容", "operator": "isEmpty"},
      {"field_name": "发送人", "operator": "isNot", "value": ["ou_bedf1873f673089685e5d71192b19a22"]},
      {"field_name": "是否撤回", "operator": "is", "value": ["false"]}
    ]
  }
}

预期结果：26000+ 条 → 约个位数候选记录。

阶段二：本地算超时（>30分钟）

对阶段一返回的每条记录，用 check.sh 脚本计算并分组：

bash /workspace/群消息超时监控/scripts/check.sh < input.json > output.json

脚本会：

  1. 逐条算 (当前时间 - 发送时间) / 60 > 30
  2. 按「所在群ID」分组
  3. 输出分组后的 JSON

阶段三：按群查撤回（查群数=N次API，而非记录数）

对阶段二输出的每个分组，用用户身份工具 feishu_im_user_get_messages 查一次消息列表：

chat_id = 组的 chat_id（如 oc_xxx）
relative_time = "last_1_days"
page_size = 50

返回值处理（逐条匹配组内记录的消息ID）：

情况结论操作
报错 Bot/User can NOT be out of the chat用户不在该群跳过该群所有记录，不做处理
消息列表中找到该消息ID未撤回记入推送列表
消息列表中找不到该消息ID已撤回用 feishu_bitable_app_table_record update，勾选「是否撤回」= true

阶段四：推送未撤回的超时话题

对确认「未撤回」的记录，每条单独推送一张消息卡片到 风控bi报表或超时提醒推送群（oc_5ab81cdc5c51744bcfa2e821c71f895b）。

卡片模板：

┌─────────────────────────────────────┐
│ 🟡 群消息未回复                      │
│                                     │
│ {消息链接}                           │
│                                     │
│ 📍 {所在群名称}                      │
└─────────────────────────────────────┘

完整流程图

开始
 │
 ├─ OAuth 有效？─── 否 ──→ 提示重新授权，终止
 │
 ├─ 阶段一：API 筛
 │   发送日期=今天 → 根消息ID=空 → 话题回复内容=空
 │   → 发送人≠风控值班 → 是否撤回=未勾选
 │   │
 │   └─ 结果：0 条 ──→ 无超时话题，结束
 │
 ├─ 阶段二：本地算超时
 │   每条算 >30分钟，按群分组
 │   │
 │   └─ 结果：0 条 ──→ 无不超时，结束
 │
 ├─ 阶段三：按群查撤回
 │   每组查一次消息列表
 │   │
 │   ├─ 不在群 → 跳过该组
 │   ├─ 找到消息ID → 未撤回
 │   └─ 找不到 → 勾选是否撤回
 │
 └─ 阶段四：推送卡片到目标群

工具使用规则（禁止事项）

身份约束

  • ❌ 禁止使用机器人身份工具查询消息（如 feishu_im_bot_image、message）
  • ❌ 禁止不使用工具自行编造查询结果
  • ❌ 禁止用关键词搜索（feishu_im_user_search_messages）代替按消息ID查话题
  • ✅ 必须使用用户身份工具 feishu_im_user_get_messages 查群消息
  • ✅ 必须使用用户身份工具 feishu_bitable_app_table_record 读写多维表格

操作约束

  • ❌ 禁止修改已勾选「是否撤回」的记录
  • ❌ 禁止单条记录重复推送（每次 cron 运行只推一次）
  • ✅ 必须在推送成功后确认消息已发出

错误处理

异常处理方式
授权失效提示重新授权，终止运行
用户不在群中跳过该群所有记录，继续处理其他群
API 限流/超时等待后重试（最多 3 次）
筛出 0 条记录正常结束，无推送
More in Security