palz-connector 1.2.6 → 1.2.7

package/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palz-connector",
-  "version": "1.2.6",
+  "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

@@ -17,6 +17,18 @@ import { createPalzReplyDispatcher } from "./reply-dispatcher.js";
 import { resolvePalzMediaList } from "./media.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;
+}
+
 // ============ 文本提取工具 ============
 
 function extractPlainText(content: OpenAIContent): string {
@@ -194,7 +206,11 @@ 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;
@@ -220,6 +236,9 @@ export async function handlePalzMessage(params: HandlePalzMessageParams): Promis
     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);
@@ -255,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）
@@ -324,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,
@@ -357,7 +381,7 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
 
   // 构建 InboundHistory（结构化历史数据，Runtime 会注入到系统提示中）
   const inboundHistory =
-    isGroup && historyKey
+    isGroup && historyKey && groupContextCacheEnabled
       ? (chatHistories.get(historyKey) ?? []).map((entry) => ({
           sender: entry.sender,
           body: entry.body,
@@ -366,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,
@@ -380,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,
@@ -418,6 +462,7 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
     enableStreaming: useStream,
     msgId: msg.msg_id,
     msgType: msg.msg_type,
+    groupId,
   });
 
   // STEP 6d: 分发消息给 AI
@@ -439,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;

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;
 }