openclaw - 💡(How to fix) Fix 多个 outbound 消息路径导致 message hook 不完整触发的问题 [1 participants]

问题描述

当前 OpenClaw 存在多条独立的 outbound 消息发送路径，这些路径与 message:sent / message_sent hook 的触发之间没有统一覆盖，导致部分出站消息无法被 internal hook 或 plugin hook 感知。

已确认的漏录场景：Telegram DM 中 agent 直接文本回复（如「清理完毕 ✅」）未落入 conversation-stream workspace hook 的 JSONL 记录中。

根因分析

出站消息路径现状

关键问题

1. deliverReplies 路径：调用时未传入 sessionKeyForInternalHooks 和 hookRunner，导致 emitMessageSentHooks() 内部条件判断失败，hook 永远不触发
2. 架构不统一：deliverReplies 和 deliverOutboundPayloads 功能高度重叠但未共用抽象，channel 实现各自为政
3. plugin message_sent gap：outbound-send-service 中 plugin-handled 路径无法触发 plugin hook（已有记录但未修复）

复现步骤

1. 配置 conversation-stream workspace hook（监听 message:sent）
2. 通过 Telegram DM 向 bot 发送消息
3. Bot agent 直接文本回复（不经 message tool）
4. 观察 memory/conversations/telegram__<peer>/<date>.jsonl — outbound 消息未落盘

影响范围

• conversation-stream hook：outbound 消息漏录，导致会话历史不完整
• 所有依赖 message:sent / message_sent hook 的插件：可能丢失发送事件

修复建议

方案 A（最小改动）

在 bot-message-dispatch.ts 调用 deliverReplies 时传入 sessionKeyForInternalHooks：

// extensions/telegram/src/bot-message-dispatch.ts
await deliverReplies({
  // ...existing params
  sessionKeyForInternalHooks: ctxPayload.SessionKey,
  hookRunner: /* 通过 runtime 或全局 hookRunner 获取 */,
});

方案 B（架构级）

引入统一 OutboundDeliveryObserver，所有 channel 发送路径最终都调用一次 observer.notify()，Hook 统一挂在这层，不再依赖各路径自行触发。

相关文件

• extensions/telegram/src/bot/delivery.replies.ts — Telegram 发送层（漏录位置）
• extensions/telegram/src/bot-message-dispatch.ts — 调用 deliverReplies 处
• src/infra/outbound/deliver.ts — deliverOutboundPayloads（参照实现）
• src/infra/outbound/outbound-send-service.ts — plugin sends，另有 gap
• workspace/hooks/conversation-stream/handler.ts — 受影响的 hook

标签

bug, hooks, telegram, architecture