palz-connector 1.2.5 → 1.2.7

package/openclaw.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "palz-connector",
   "name": "Palz Connector Channel",
-  "version": "1.2.5",
+  "version": "1.2.7",
   "description": "Palz IM 接入 OpenClaw",
   "channels": [
     "palz-connector"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palz-connector",
-  "version": "1.2.5",
+  "version": "1.2.7",
   "type": "module",
   "main": "index.ts",
   "description": "Palz IM 接入 OpenClaw — 模块化架构，基于 OpenClaw Runtime 消息管道",

package/palz-connector.config.json

@@ -2,5 +2,6 @@
   "enabled": true,
   "streamUrl": "ws://14.103.148.99:9090/ws/bot",
   "apiBaseUrl": "http://14.103.148.99:9090/api",
-  "sessionTimeout": 1800000
+  "sessionTimeout": 1800000,
+  "groupContextCache": false
 }

package/palz-connector.dev.config.json

@@ -2,5 +2,6 @@
   "enabled": true,
   "streamUrl": "wss://claw-server.csaiagent.com/ws/bot",
   "apiBaseUrl": "https://claw-server.csaiagent.com/api",
-  "sessionTimeout": 1800000
+  "sessionTimeout": 1800000,
+  "groupContextCache": false
 }

package/palz-connector.prod.config.json

@@ -2,5 +2,6 @@
   "enabled": true,
   "streamUrl": "wss://claw-server.csagentai.com/ws/bot",
   "apiBaseUrl": "https://claw-server.csagentai.com/api",
-  "sessionTimeout": 1800000
+  "sessionTimeout": 1800000,
+  "groupContextCache": false
 }

package/palz-connector.staging.config.json

@@ -2,5 +2,6 @@
   "enabled": true,
   "streamUrl": "wss://claw-server.csjkagent.com/ws/bot",
   "apiBaseUrl": "https://claw-server.csjkagent.com/api",
-  "sessionTimeout": 1800000
+  "sessionTimeout": 1800000,
+  "groupContextCache": false
 }

package/src/bot.ts

@@ -15,7 +15,19 @@ import { resolvePalzAccount } from "./config.js";
 import { tryClaimMessage } from "./dedup.js";
 import { createPalzReplyDispatcher } from "./reply-dispatcher.js";
 import { resolvePalzMediaList } from "./media.js";
-import type { PalzMessageEvent, OpenAIContent, ContentPart, TextContentPart } from "./types.js";
+import type { PalzMessageEvent, OpenAIContent, ContentPart, TextContentPart, PalzMediaInfo } from "./types.js";
+
+// ============ group_id 解析 ============
+
+/** 从 conversation_id 中解析 group_id，格式: user_{userID}_lobster_{lobsterID}_group_{groupID}_release_{releaseName} */
+const GROUP_ID_RE = /_group_([^_]+)_release_/;
+
+function resolveGroupId(msg: PalzMessageEvent): string | undefined {
+  if (msg.group_id) return msg.group_id;
+  if (msg.conversation_type !== "group") return undefined;
+  const m = GROUP_ID_RE.exec(msg.conversation_id);
+  return m ? m[1] : undefined;
+}
 
 // ============ 文本提取工具 ============
 
@@ -51,6 +63,7 @@ const enqueue = createChatQueue();
 interface HistoryEntry {
   sender: string;
   body: string;
+  mediaList?: PalzMediaInfo[];
   timestamp: number;
   messageId: string;
 }
@@ -193,25 +206,39 @@ export async function handlePalzMessage(params: HandlePalzMessageParams): Promis
 
   // 群聊 @提及检测
   const wasMentioned = isGroup ? (msg.mentioned_bot === true) : true;
-  if (isGroup && !wasMentioned) {
-    // 未@机器人：记录到群聊历史，下次被@时作为上下文
+  // 群聊上下文缓存：groupContextCache=true（默认）时，未@消息仅缓存不发送；
+  //                  groupContextCache=false 时，所有群聊消息都发送给AI
+  const account = resolvePalzAccount({ cfg, accountId });
+  const groupContextCacheEnabled = account.config.groupContextCache !== false;
+  if (isGroup && !wasMentioned && groupContextCacheEnabled) {
+    // 未@机器人：记录到群聊历史（含媒体），下次被@时作为上下文
     const historyKey = `${effectiveAgentId}:${msg.conversation_id}`;
     const senderName = msg.sender_name || msg.sender_id;
     log(`${tag}: [STEP 1 群聊历史] 未@机器人, 准备记录历史 historyKey=${historyKey} mentioned_bot=${msg.mentioned_bot} conversation_type=${msg.conversation_type}`);
+    // 解析媒体文件（图片/文档等），缓存到本地
+    const historyMediaList = await resolvePalzMediaList(msg.content, log);
+    log(`${tag}: [STEP 1 群聊历史] 媒体解析完成: mediaCount=${historyMediaList.length}`);
+    const bodyWithPlaceholder = historyMediaList.length > 0
+      ? `${senderName}: ${plainText} ${historyMediaList.map(m => m.placeholder).join(' ')}`
+      : `${senderName}: ${plainText}`;
     recordGroupHistoryEntry({
       historyKey,
       entry: {
         sender: msg.sender_id,
-        body: `${senderName}: ${plainText}`,
+        body: bodyWithPlaceholder,
+        mediaList: historyMediaList.length > 0 ? historyMediaList : undefined,
         timestamp: Date.now(),
         messageId: msg.msg_id,
       },
       limit: DEFAULT_GROUP_HISTORY_LIMIT,
       log,
     });
-    log(`${tag}: [STEP 1 跳过] 原因=群聊中未@机器人, 已记录到历史 historyKey=${historyKey}`);
+    log(`${tag}: [STEP 1 跳过] 原因=群聊中未@机器人, 已记录到历史 historyKey=${historyKey} mediaCount=${historyMediaList.length}`);
     return;
   }
+  if (isGroup && !wasMentioned && !groupContextCacheEnabled) {
+    log(`${tag}: [STEP 1 群聊直通] groupContextCache=false, 未@消息也将发送给AI mentioned_bot=${msg.mentioned_bot}`);
+  }
 
   // 去重（按 agentId + conversationId 隔离，同群多 bot 场景）
   const claimed = tryClaimMessage(msg.msg_id, effectiveAgentId, msg.conversation_id);
@@ -247,6 +274,10 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
   const plainText = extractPlainText(msg.content).trim();
   const useStream = msg.stream === true;
   const senderName = msg.sender_name || msg.sender_id;
+  const groupId = resolveGroupId(msg);
+  if (isGroup) {
+    log(`${tag}: [group_id] resolved=${groupId ?? "(none)"} from_msg=${msg.group_id ?? "(none)"} conv=${msg.conversation_id}`);
+  }
 
   // 群聊：peerId = chat:conversation_id（整群共享 session，与 palzTo 格式一致）
   // DM：peerId = sender_id:conversation_id（每用户每会话独立 session）
@@ -258,7 +289,7 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
     : 0;
   log(`${tag}: [STEP 4/6 媒体解析] 输入: contentType=${typeof msg.content === "string" ? "string" : "array"} mediaCount=${mediaCount}`);
   const mediaList = await resolvePalzMediaList(msg.content, log);
-  const mediaPayload = buildMediaPayload(mediaList);
+  let mediaPayload = buildMediaPayload(mediaList);
   log(`${tag}: [STEP 4 输出] mediaList=${JSON.stringify(mediaList.map((m) => ({ path: m.path, contentType: m.contentType })))} mediaPayload=${JSON.stringify(mediaPayload)}`);
 
   // STEP 5: 解析路由
@@ -316,10 +347,11 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
 
   const chatType = isGroup ? "group" : "direct";
 
-  // 群聊历史：将积攒的未@消息拼入 Body 上下文
-  const historyKey = isGroup ? `${effectiveAgentId}:${msg.conversation_id}` : undefined;
+  // 群聊历史：将积攒的未@消息拼入 Body 上下文（仅 groupContextCache=true 时生效）
+  const groupContextCacheEnabled = account.config.groupContextCache !== false;
+  const historyKey = isGroup && groupContextCacheEnabled ? `${effectiveAgentId}:${msg.conversation_id}` : undefined;
   let combinedBody = body;
-  if (isGroup && historyKey) {
+  if (isGroup && historyKey && groupContextCacheEnabled) {
     log(`${tag}: [STEP 6b 群聊历史] 开始构建, historyKey=${historyKey} bodyLen=${body.length}`);
     combinedBody = buildGroupHistoryContext({
       historyKey,
@@ -336,11 +368,20 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
     });
     log(`${tag}: [STEP 6b 群聊历史] 构建完成, historyKey=${historyKey} bodyLen=${body.length} combinedBodyLen=${combinedBody.length} hasHistory=${combinedBody.length !== body.length}`);
     // log(`${tag}: [STEP 6b 群聊历史] combinedBody=\n${combinedBody}`);
+
+    // 将历史中缓存的媒体合并到当前 mediaPayload
+    const historyEntries = chatHistories.get(historyKey) ?? [];
+    const historyMediaList = historyEntries.flatMap(e => e.mediaList ?? []);
+    if (historyMediaList.length > 0) {
+      const allMedia = [...historyMediaList, ...mediaList];
+      mediaPayload = buildMediaPayload(allMedia);
+      log(`${tag}: [STEP 6b 历史媒体合并] historyMedia=${historyMediaList.length} currentMedia=${mediaList.length} totalMedia=${allMedia.length}`);
+    }
   }
 
   // 构建 InboundHistory（结构化历史数据，Runtime 会注入到系统提示中）
   const inboundHistory =
-    isGroup && historyKey
+    isGroup && historyKey && groupContextCacheEnabled
       ? (chatHistories.get(historyKey) ?? []).map((entry) => ({
           sender: entry.sender,
           body: entry.body,
@@ -349,6 +390,25 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
       : undefined;
   log(`${tag}: [STEP 6b InboundHistory] count=${inboundHistory?.length ?? 0}`);
 
+  // 构建 UntrustedContext：将 IM 消息的关键字段注入到 AI agent 的上下文中
+  const untrustedContext: string[] = [
+    `sender_id: ${msg.sender_id}`,
+    `sender_name: ${senderName}`,
+    `conversation_id: ${msg.conversation_id}`,
+    `conversation_type: ${msg.conversation_type || "direct"}`,
+    `mentioned_bot: ${wasMentioned}`,
+  ];
+  if (groupId) {
+    untrustedContext.push(`group_id: ${groupId}`);
+  }
+  if (msg.owner_id) {
+    untrustedContext.push(`owner_id: ${msg.owner_id}`);
+  }
+  if (msg.owner_name) {
+    untrustedContext.push(`owner_name: ${msg.owner_name}`);
+  }
+  log(`${tag}: [STEP 6b UntrustedContext] entries=${untrustedContext.length} values=${JSON.stringify(untrustedContext)}`);
+
   const ctx = core.channel.reply.finalizeInboundContext({
     Body: combinedBody,
     BodyForAgent: messageBody,
@@ -363,6 +423,7 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
     GroupSubject: isGroup ? msg.conversation_id : undefined,
     SenderId: msg.sender_id,
     SenderName: senderName,
+    UntrustedContext: untrustedContext,
     Provider: "palz-connector",
     Surface: "palz-connector",
     MessageSid: msg.msg_id,
@@ -401,6 +462,7 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
     enableStreaming: useStream,
     msgId: msg.msg_id,
     msgType: msg.msg_type,
+    groupId,
   });
 
   // STEP 6d: 分发消息给 AI
@@ -422,7 +484,7 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
   });
 
   // AI 回复完成后清空群聊历史（已拼入上下文，避免下次重复）
-  if (isGroup && historyKey) {
+  if (isGroup && historyKey && groupContextCacheEnabled) {
     clearGroupHistory(historyKey, log);
   }
 

package/src/config.ts

@@ -72,6 +72,7 @@ export function resolvePalzConfig(_cfg?: any): PalzConfig {
     streamUrl: file.streamUrl || "",
     apiBaseUrl: file.apiBaseUrl || "",
     sessionTimeout: file.sessionTimeout ?? DEFAULT_SESSION_TIMEOUT,
+    groupContextCache: file.groupContextCache !== false,
   };
   if (!_configLoggedOnce) {
     _configLoggedOnce = true;

package/src/reply-dispatcher.ts

@@ -42,6 +42,7 @@ export interface CreatePalzReplyDispatcherParams {
   enableStreaming: boolean;
   msgId: string;
   msgType?: string;
+  groupId?: string;
 }
 
 export function createPalzReplyDispatcher(params: CreatePalzReplyDispatcherParams) {
@@ -57,6 +58,7 @@ export function createPalzReplyDispatcher(params: CreatePalzReplyDispatcherParam
     enableStreaming,
     msgId,
     msgType,
+    groupId,
   } = params;
 
   const log = typeof runtime?.log === "function" ? runtime.log : console.log;
@@ -87,6 +89,7 @@ export function createPalzReplyDispatcher(params: CreatePalzReplyDispatcherParam
       senderId,
       stream: streamOpts,
       msgType,
+      groupId,
     });
     log(`${tag}: [DISPATCHER←sendToIM] 输出: ${JSON.stringify(result)}`);
     return result;

package/src/send.ts

@@ -14,7 +14,7 @@ function nextMsgId(): string {
 }
 
 export async function sendToPalzIM(params: SendToIMParams): Promise<any> {
-  const { config, conversationId, content, conversationType, msgId, senderId, stream, msgType } = params;
+  const { config, conversationId, content, conversationType, msgId, senderId, stream, msgType, groupId } = params;
   const url = `${config.apiBaseUrl}/bot/send`;
   const resolvedMsgId = msgId || nextMsgId();
 
@@ -34,6 +34,10 @@ export async function sendToPalzIM(params: SendToIMParams): Promise<any> {
     reqBody.msg_type = msgType;
   }
 
+  if (groupId) {
+    reqBody.group_id = groupId;
+  }
+
   if (stream) {
     reqBody.stream_id = stream.streamId;
     reqBody.seq = stream.seq;
@@ -41,15 +45,16 @@ export async function sendToPalzIM(params: SendToIMParams): Promise<any> {
     reqBody.delta = stream.delta;
   }
 
+  const reqBodyStr = JSON.stringify(reqBody);
   console.log(
-    `palz-send: [HTTP_REQ] POST ${url}\n  request_body=${JSON.stringify(reqBody).slice(0, 800)}`,
+    `palz-send: [HTTP_REQ] POST ${url} body_length=${reqBodyStr.length}\n  request_body=${reqBodyStr}`,
   );
 
   const startMs = Date.now();
   const response = await fetch(url, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
-    body: JSON.stringify(reqBody),
+    body: reqBodyStr,
   });
   const elapsedMs = Date.now() - startMs;
 

package/src/types.ts

@@ -31,6 +31,12 @@ export interface PalzMessageEvent {
   mentioned_bot?: boolean;
   /** 可选，IM 下发的消息类型，回复时原样透传 */
   msg_type?: string;
+  /** Bot 所属用户的 ID */
+  owner_id?: string;
+  /** Bot 所属用户的用户名 */
+  owner_name?: string;
+  /** 群组 ID，群聊时 IM 可直接下发；若未提供则从 conversation_id 中解析 */
+  group_id?: string;
 }
 
 // ============ 配置 ============
@@ -41,6 +47,8 @@ export interface PalzConfig {
   streamUrl?: string;
   apiBaseUrl?: string;
   sessionTimeout?: number;
+  /** 群聊上下文缓存开关：true=未@消息缓存为上下文（默认），false=所有群聊消息直接发送给AI */
+  groupContextCache?: boolean;
 }
 
 export interface ResolvedPalzAccount {
@@ -78,4 +86,6 @@ export interface SendToIMParams {
   stream?: StreamChunkOpts;
   /** IM 下发的消息类型，回复时原样透传 */
   msgType?: string;
+  /** 群组 ID，群聊时透传 */
+  groupId?: string;
 }