@core-workspace/infoflow-openclaw-plugin 2026.3.9 → 2026.3.32

package/src/handler/message-handler.ts

@@ -31,6 +31,7 @@ import type {
   InfoflowMessageEvent,
   InfoflowMentionIds,
   InfoflowReplyMode,
+  InfoflowGroupSessionMode,
   InfoflowGroupConfig,
   HandleInfoflowMessageParams,
   HandlePrivateChatParams,
@@ -78,12 +79,8 @@ export async function handlePrivateChatMessage(params: HandlePrivateChatParams):
     imageUrls.push(picUrl.trim());
   }
 
-  logVerbose(
-    `[infoflow] private chat: fromuser=${fromuser}, senderName=${senderName}, mes=${mes}, msgType=${msgType}, raw msgData: ${JSON.stringify(msgData)}`,
-  );
-
-  logVerbose(
-    `[DEBUG private] content字段诊断: Content=${JSON.stringify(msgData.Content)}, content=${JSON.stringify(msgData.content)}, mes=${JSON.stringify(msgData.mes)}, MsgType=${JSON.stringify(msgData.MsgType)}, msgtype=${JSON.stringify(msgData.msgtype)}, PicUrl=${JSON.stringify(msgData.PicUrl)}, picurl=${JSON.stringify(msgData.picurl)}, imageUrls=${JSON.stringify(imageUrls)}`,
+  getInfoflowBotLog().info(
+    `[inbound:dm] from=${fromuser}, name=${senderName}, msgType=${msgType}, msgId=${messageIdStr ?? "?"}, text=${mes.slice(0, 80)}${mes.length > 80 ? "..." : ""}, images=${imageUrls.length}`,
   );
 
   if (!fromuser || (!mes.trim() && imageUrls.length === 0)) {
@@ -161,21 +158,7 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
   const timestamp = rawTime != null ? Number(rawTime) : Date.now();
 
   // Debug: 打印完整的原始消息数据
-  logVerbose(`[DEBUG bot.groupchat] 完整 msgData: ${JSON.stringify(msgData, null, 2)}`);
-  logVerbose(`[DEBUG bot.groupchat] 完整 header: ${JSON.stringify(header, null, 2)}`);
-
-  // Debug: 输出所有可能的 ID 字段
-  logVerbose(`[DEBUG bot.groupchat] 查找 imid (期望值: 102752365):`);
-  logVerbose(`  - header.imid: ${header?.imid}`);
-  logVerbose(`  - header.fromimid: ${header?.fromimid}`);
-  logVerbose(`  - header.fromuserid: ${header?.fromuserid}`);
-  logVerbose(`  - msgData.imid: ${msgData.imid}`);
-  logVerbose(`  - msgData.fromimid: ${msgData.fromimid}`);
-  logVerbose(`  - msgData.fromuserid: ${msgData.fromuserid}`);
-  logVerbose(`  - msgData.from: ${msgData.from}`);
-  logVerbose(`  - msgData.userid: ${msgData.userid}`);
-  logVerbose(`  - fromuser: ${fromuser}`);
-  logVerbose(`  - senderImidStr: ${senderImidStr}`);
+  logVerbose(`[inbound:group:raw] msgData: ${JSON.stringify(msgData, null, 2)}`);
 
   if (!fromuser) {
     return;
@@ -246,13 +229,9 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
         }
       } else if (item.type === "IMAGE") {
         // 提取图片下载地址
-        logVerbose(`[DEBUG bot.groupchat] IMAGE item: ${JSON.stringify(item, null, 2)}`);
         const url = item.downloadurl;
         if (typeof url === "string" && url.trim()) {
-          logVerbose(`[DEBUG bot.groupchat] 提取到图片URL: ${url}`);
           imageUrls.push(url.trim());
-        } else {
-          logVerbose(`[DEBUG bot.groupchat] WARNING: IMAGE item 缺少有效的 downloadurl 字段`);
         }
       }
     }
@@ -268,7 +247,6 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
   }
   // 纯图片消息：设置占位符
   if (!mes && imageUrls.length > 0) {
-    logVerbose(`[DEBUG bot.groupchat] 纯图片消息: ${imageUrls.length} 张图片`);
     mes = `<media:image>${imageUrls.length > 1 ? ` (${imageUrls.length} images)` : ""}`;
   }
   // If mes is empty but replyContext exists, use a placeholder so the message is not dropped
@@ -279,6 +257,10 @@ export async function handleGroupChatMessage(params: HandleGroupChatParams): Pro
   // Extract sender name from header or fallback to fromuser
   const senderName = String(header?.username ?? header?.nickname ?? msgData.username ?? fromuser);
 
+  getInfoflowBotLog().info(
+    `[inbound:group] from=${fromuser}, name=${senderName}, group=${groupid}, msgId=${messageIdStr ?? "?"}, mentioned=${wasMentioned}, text=${mes.slice(0, 80)}${mes.length > 80 ? "..." : ""}, images=${imageUrls.length}, reply=${replyContextItems.length > 0}`,
+  );
+
   // Delegate to the common message handler (group chat)
   await handleInfoflowMessage({
     cfg,
@@ -316,10 +298,8 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
   const core = getInfoflowRuntime();
 
   const isGroup = chatType === "group";
-  // Convert groupId (number) to string for peerId since routing expects string
-  const peerId = isGroup ? (groupId !== undefined ? String(groupId) : fromuser) : fromuser;
 
-  // Resolve per-group config for replyMode gating
+  // Resolve per-group config for replyMode gating (needed for groupSessionMode)
   const groupCfg = isGroup ? resolveGroupConfig(account, groupId) : undefined;
 
   // "ignore" mode: discard immediately, no save, no think, no reply
@@ -327,6 +307,18 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     return;
   }
 
+  // Determine group session mode for peerId generation (group config overrides account config)
+  const groupSessionMode = isGroup ? groupCfg!.groupSessionMode : "group";
+  // Convert groupId (number) to string for peerId since routing expects string
+  // When groupSessionMode is "user", peerId includes the user ID to split sessions by user within group
+  const peerId = isGroup
+    ? groupId !== undefined
+      ? groupSessionMode === "user"
+        ? `${groupId}:${fromuser}`
+        : String(groupId)
+      : fromuser
+    : fromuser;
+
   // Resolve route based on chat type
   const route = core.channel.routing.resolveAgentRoute({
     cfg,
@@ -348,7 +340,11 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
   });
 
   // Build conversation label and from address based on chat type
-  const fromLabel = isGroup ? `group:${groupId}` : senderName || fromuser;
+  const fromLabel = isGroup
+    ? groupSessionMode === "user"
+      ? `group:${groupId}:${senderName || fromuser}`
+      : `group:${groupId}`
+    : `infoflow-${senderName || fromuser}`;
   const fromAddress = isGroup ? `infoflow:group:${groupId}` : `infoflow:${fromuser}`;
   const toAddress = isGroup ? `infoflow:group:${groupId}` : `infoflow:${fromuser}`;
 
@@ -362,7 +358,11 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
   });
 
   // Inject accumulated group chat history into the body for context
-  const historyKey = isGroup && groupId !== undefined ? String(groupId) : undefined;
+  const historyKey = isGroup && groupId !== undefined
+    ? groupSessionMode === "user"
+      ? `${groupId}:${fromuser}`
+      : String(groupId)
+    : undefined;
   let combinedBody = body;
   if (isGroup && historyKey) {
     combinedBody = buildPendingHistoryContextFromMap({
@@ -395,9 +395,8 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
   const mediaList: Array<{ path: string; contentType?: string }> = [];
   const failReasons: string[] = [];
 
-  logVerbose(`[DEBUG bot] 图片处理开始: imageUrls数量=${event.imageUrls?.length ?? 0}`);
+  logVerbose(`[inbound] 图片处理: urls=${event.imageUrls?.length ?? 0}`);
   if (event.imageUrls && event.imageUrls.length > 0) {
-    logVerbose(`[DEBUG bot] 待下载图片URLs: ${JSON.stringify(event.imageUrls)}`);
     // Collect unique hostnames from image URLs for SSRF allowlist.
     // Infoflow image servers (e.g. xp2.im.baidu.com, e4hi.im.baidu.com) resolve to
     // internal IPs on Baidu's network, so they need to be explicitly allowed.
@@ -417,38 +416,33 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     const urls = event.imageUrls.slice(0, INFOFLOW_MAX_IMAGES);
     const results = await Promise.allSettled(
       urls.map(async (imageUrl) => {
-        logVerbose(`[DEBUG bot] 开始下载图片: ${imageUrl}`);
         const fetched = await core.channel.media.fetchRemoteMedia({
           url: imageUrl,
           maxBytes: mediaMaxBytes,
           ssrfPolicy,
         });
-        logVerbose(`[DEBUG bot] 图片下载成功: size=${fetched.buffer.length}, contentType=${fetched.contentType}`);
         const saved = await core.channel.media.saveMediaBuffer(
           fetched.buffer,
           fetched.contentType ?? undefined,
           "inbound",
           mediaMaxBytes,
         );
-        logVerbose(`[infoflow] downloaded image from ${imageUrl}, saved to ${saved.path}`);
-        logVerbose(`[DEBUG bot] 图片保存成功: path=${saved.path}`);
+        logVerbose(`[inbound] image downloaded: url=${imageUrl}, size=${fetched.buffer.length}, saved=${saved.path}`);
         return { path: saved.path, contentType: saved.contentType ?? fetched.contentType };
       }),
     );
     for (const result of results) {
       if (result.status === "fulfilled") {
         mediaList.push(result.value);
-        logVerbose(`[DEBUG bot] 图片处理成功: ${result.value.path}`);
       } else {
         const reason = String(result.reason);
-        logVerbose(`[infoflow] failed to download image: ${reason}`);
-        logVerbose(`[DEBUG bot] 图片下载失败: ${reason}`);
+        logVerbose(`[inbound] image download failed: ${reason}`);
         failReasons.push(reason);
       }
     }
   }
 
-  logVerbose(`[DEBUG bot] 图片处理完成: 成功=${mediaList.length}, 失败=${failReasons.length}`);
+  logVerbose(`[inbound] 图片处理完成: ok=${mediaList.length}, fail=${failReasons.length}`);
 
   const mediaPayload = buildAgentMediaPayload(mediaList);
 
@@ -521,17 +515,22 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
   let triggerReason = "direct-message";
   if (isGroup && groupCfg) {
     const { replyMode } = groupCfg;
-    const groupIdStr = groupId !== undefined ? String(groupId) : undefined;
+    // Generate key for history tracking and follow-up window based on groupSessionMode
+    const historyReplyKey = groupId !== undefined
+      ? groupSessionMode === "user"
+        ? `${groupId}:${fromuser}`
+        : String(groupId)
+      : undefined;
 
     // "record" mode: save to session only, no think, no reply
     if (replyMode === "record") {
-      if (groupIdStr) {
+      if (historyReplyKey) {
         logVerbose(
           `[infoflow:bot] pending: from=${fromuser}, group=${groupId}, reason=record-mode`,
         );
         recordPendingHistoryEntryIfEnabled({
           historyMap: chatHistories,
-          historyKey: groupIdStr,
+          historyKey: historyReplyKey,
           entry: { sender: senderName || fromuser, body: mes, timestamp: Date.now() },
           limit: DEFAULT_GROUP_HISTORY_LIMIT,
         });
@@ -543,27 +542,29 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     const wasMentioned = event.wasMentioned === true;
 
     if (replyMode === "mention-only") {
-      // Only reply if bot was @mentioned
-      const shouldReply = canDetectMention && wasMentioned;
+      // Only reply if bot was @mentioned.
+      // If robotName is not configured, @mention detection is impossible —
+      // fall back to treating every message as a trigger (same as proactive).
+      const shouldReply = !canDetectMention || wasMentioned;
       if (shouldReply) {
         triggerReason = "bot-mentioned";
       } else {
         // Check follow-up window: if bot recently replied, allow LLM to decide
         if (
           groupCfg.followUp &&
-          groupIdStr &&
-          isWithinFollowUpWindow(groupIdStr, groupCfg.followUpWindow)
+          historyReplyKey &&
+          isWithinFollowUpWindow(historyReplyKey, groupCfg.followUpWindow)
         ) {
           triggerReason = "followUp";
           ctxPayload.GroupSystemPrompt = buildFollowUpPrompt();
         } else {
-          if (groupIdStr) {
+          if (historyReplyKey) {
             logVerbose(
               `[infoflow:bot] pending: from=${fromuser}, group=${groupId}, reason=mention-only-not-mentioned`,
             );
             recordPendingHistoryEntryIfEnabled({
               historyMap: chatHistories,
-              historyKey: groupIdStr,
+              historyKey: historyReplyKey,
               entry: { sender: senderName || fromuser, body: mes, timestamp: Date.now() },
               limit: DEFAULT_GROUP_HISTORY_LIMIT,
             });
@@ -572,8 +573,9 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
         }
       }
     } else if (replyMode === "mention-and-watch") {
-      // Reply if bot @mentioned, or if watched person @mentioned, or follow-up
-      const botMentioned = canDetectMention && wasMentioned;
+      // Reply if bot @mentioned, or if watched person @mentioned, or follow-up.
+      // If robotName is not configured, fall back to treating every message as a trigger.
+      const botMentioned = !canDetectMention || wasMentioned;
       if (botMentioned) {
         triggerReason = "bot-mentioned";
       } else {
@@ -594,20 +596,20 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
           ctxPayload.GroupSystemPrompt = buildWatchRegexPrompt(groupCfg.watchRegex);
         } else if (
           groupCfg.followUp &&
-          groupIdStr &&
-          isWithinFollowUpWindow(groupIdStr, groupCfg.followUpWindow)
+          historyReplyKey &&
+          isWithinFollowUpWindow(historyReplyKey, groupCfg.followUpWindow)
         ) {
           triggerReason = "followUp";
           // Follow-up window: let LLM decide if this is a follow-up
           ctxPayload.GroupSystemPrompt = buildFollowUpPrompt();
         } else {
-          if (groupIdStr) {
+          if (historyReplyKey) {
             logVerbose(
               `[infoflow:bot] pending: from=${fromuser}, group=${groupId}, reason=mention-and-watch-no-trigger`,
             );
             recordPendingHistoryEntryIfEnabled({
               historyMap: chatHistories,
-              historyKey: groupIdStr,
+              historyKey: historyReplyKey,
               entry: { sender: senderName || fromuser, body: mes, timestamp: Date.now() },
               limit: DEFAULT_GROUP_HISTORY_LIMIT,
             });
@@ -663,21 +665,11 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     }
   }
 
-  logVerbose(
-    `[infoflow:bot] dispatching to LLM: from=${fromuser}, group=${groupId ?? "N/A"}, trigger=${triggerReason}, replyMode=${groupCfg?.replyMode ?? "N/A"}`,
+  getInfoflowBotLog().info(
+    `[dispatch] from=${fromuser}, to=${to}, chatType=${chatType}, trigger=${triggerReason}, replyMode=${groupCfg?.replyMode ?? "N/A"}, session=${route.sessionKey}`,
   );
 
-  // Debug: Log reply-to context
-  logVerbose(`[DEBUG bot] event.messageId=${event.messageId}, event.senderImid=${event.senderImid}, isGroup=${isGroup}, mes=${mes.slice(0, 50)}`);
-  if (!event.messageId) {
-    logVerbose(`[DEBUG bot] WARNING: event.messageId is undefined/null!`);
-  }
-  if (!event.senderImid) {
-    logVerbose(`[DEBUG bot] WARNING: event.senderImid is undefined/null!`);
-  }
-  if (!isGroup) {
-    logVerbose(`[DEBUG bot] Not a group message, skipping reply-to`);
-  }
+  logVerbose(`[dispatch:detail] messageId=${event.messageId}, senderImid=${event.senderImid}, images=${mediaList.length}`);
 
   // Send "processing" hint if LLM takes longer than processingHintDelay seconds
   // (default: 5s). Gives users feedback without spamming fast responses.
@@ -704,7 +696,7 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
       sendInfoflowMessage({
         cfg,
         to,
-        contents: [{ type: "text", content: "⏳ 处理中..." }],
+        contents: [{ type: "text", content: "👌收到啦" }],
         accountId: account.accountId,
         replyTo: processingReplyTo,
       }).catch(() => {});
@@ -729,6 +721,8 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
     messageFormat: isGroup
       ? (account.config.groupMessageFormat ?? "text")
       : (account.config.dmMessageFormat ?? "text"),
+    // Chunk size: per-account config, default 1800
+    textChunkLimit: account.config.textChunkLimit ?? 1800,
   });
 
   // Cancel processing hint the moment the first real message starts being delivered,
@@ -756,15 +750,15 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
   cancelProcessingHint?.();
 
   // If hint was shown to the user, send "搞定" so they know the task is done
-  if (hintWasSent) {
-    const elapsedSec = Math.round((Date.now() - dispatchStartTime) / 1000);
-    sendInfoflowMessage({
-      cfg,
-      to,
-      contents: [{ type: "text", content: `任务完成 ✨ (${elapsedSec}s)` }],
-      accountId: account.accountId,
-    }).catch(() => {});
-  }
+  // if (hintWasSent) {
+  //   const elapsedSec = Math.round((Date.now() - dispatchStartTime) / 1000);
+  //   sendInfoflowMessage({
+  //     cfg,
+  //     to,
+  //     contents: [{ type: "text", content: `任务完成 ✨ (${elapsedSec}s)` }],
+  //     accountId: account.accountId,
+  //   }).catch(() => {});
+  // }
 
   const didReply = dispatchResult?.queuedFinal ?? false;
 
@@ -779,11 +773,12 @@ export async function handleInfoflowMessage(params: HandleInfoflowMessageParams)
 
   // Record bot reply timestamp for follow-up window tracking
   if (didReply && isGroup && groupId !== undefined) {
-    recordGroupReply(String(groupId));
+    const replyKey = groupSessionMode === "user" ? `${groupId}:${fromuser}` : String(groupId);
+    recordGroupReply(replyKey);
   }
 
-  logVerbose(
-    `[infoflow] dispatch complete: ${chatType} from ${fromuser}, replied=${didReply}, finalCount=${dispatchResult?.counts.final ?? 0}, hasGroupSystemPrompt=${Boolean(ctxPayload.GroupSystemPrompt)}`,
+  getInfoflowBotLog().info(
+    `[dispatch:done] from=${fromuser}, to=${to}, replied=${didReply}, blocks=${dispatchResult?.counts.final ?? 0}, elapsed=${Date.now() - dispatchStartTime}ms`,
   );
 }
 

package/src/security/group-policy.ts

@@ -150,6 +150,7 @@ export function isWithinFollowUpWindow(groupId: string, windowSeconds: number):
 
 export type ResolvedGroupConfig = {
   replyMode: InfoflowReplyMode;
+  groupSessionMode: InfoflowGroupSessionMode;
   followUp: boolean;
   followUpWindow: number;
   watchMentions: string[];
@@ -175,6 +176,7 @@ export function resolveGroupConfig(
     groupId != null ? account.config.groups?.[String(groupId)] : undefined;
   return {
     replyMode: groupCfg?.replyMode ?? account.config.replyMode ?? inferLegacyReplyMode(account),
+    groupSessionMode: groupCfg?.groupSessionMode ?? account.config.groupSessionMode ?? "group",
     followUp: groupCfg?.followUp ?? account.config.followUp ?? true,
     followUpWindow: groupCfg?.followUpWindow ?? account.config.followUpWindow ?? 300,
     watchMentions: groupCfg?.watchMentions ?? account.config.watchMentions ?? [],

package/src/types.ts

@@ -19,9 +19,14 @@ export type InfoflowReplyMode =
   | "mention-and-watch"
   | "proactive";
 
+/** Group session mode: whether to split sessions by group or by group+user */
+export type InfoflowGroupSessionMode = "group" | "user";
+
 /** Per-group configuration overrides */
 export type InfoflowGroupConfig = {
   replyMode?: InfoflowReplyMode;
+  /** Group session mode: "group" = one session per group, "user" = one session per user in group */
+  groupSessionMode?: InfoflowGroupSessionMode;
   systemPrompt?: string;
   /** Enable follow-up replies after bot responds (default: true) */
   followUp?: boolean;
@@ -128,6 +133,8 @@ export type InfoflowAccountConfig = {
   watchRegex?: string;
   /** Reply mode controlling bot engagement level in groups */
   replyMode?: InfoflowReplyMode;
+  /** Group session mode: "group" = one session per group, "user" = one session per user in group (default: "group") */
+  groupSessionMode?: InfoflowGroupSessionMode;
   /** Enable follow-up replies after bot responds to a mention (default: true) */
   followUp?: boolean;
   /** Follow-up window in seconds after last bot reply (default: 300) */
@@ -162,6 +169,12 @@ export type InfoflowAccountConfig = {
    * Default: "text"
    */
   groupMessageFormat?: "text" | "markdown";
+  /**
+   * Maximum character limit per outbound message chunk.
+   * Long messages are automatically split into multiple messages each within this limit.
+   * Default: 1800
+   */
+  textChunkLimit?: number;
 };
 
 export type ResolvedInfoflowAccount = {
@@ -195,6 +208,8 @@ export type ResolvedInfoflowAccount = {
     watchRegex?: string;
     /** Reply mode controlling bot engagement level in groups */
     replyMode?: InfoflowReplyMode;
+    /** Group session mode: "group" = one session per group, "user" = one session per user in group (default: "group") */
+    groupSessionMode?: InfoflowGroupSessionMode;
     /** Enable follow-up replies after bot responds to a mention (default: true) */
     followUp?: boolean;
     /** Follow-up window in seconds after last bot reply (default: 300) */
@@ -214,10 +229,11 @@ export type ResolvedInfoflowAccount = {
      * Default: "text"
      */
     groupMessageFormat?: "text" | "markdown";
-    dmPolicy?: string;
-    allowFrom?: string[];
-    groupPolicy?: string;
-    groupAllowFrom?: string[];
+    /**
+     * Maximum character limit per outbound message chunk.
+     * Default: 1800
+     */
+    textChunkLimit?: number;
   };
 };