palz-connector 1.2.1 → 1.2.3

package/openclaw.plugin.json

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

package/package.json

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

package/palz-connector.prod.config.json

@@ -1,6 +1,6 @@
 {
   "enabled": true,
-  "streamUrl": "wss://claw-server.uniclaw.tech/ws/bot",
-  "apiBaseUrl": "https://claw-server.uniclaw.tech/api",
+  "streamUrl": "wss://claw-server.csagentai.com/ws/bot",
+  "apiBaseUrl": "https://claw-server.csagentai.com/api",
   "sessionTimeout": 1800000
 }

package/src/bot.ts

@@ -46,6 +46,91 @@ function createChatQueue() {
 
 const enqueue = createChatQueue();
 
+// ============ 群聊历史记录 ============
+
+interface HistoryEntry {
+  sender: string;
+  body: string;
+  timestamp: number;
+  messageId: string;
+}
+
+const DEFAULT_GROUP_HISTORY_LIMIT = 50;
+const MAX_HISTORY_KEYS = 3000;
+
+/** 群聊历史缓存，key = historyKey（agentId:conversationId） */
+const chatHistories = new Map<string, HistoryEntry[]>();
+
+function recordGroupHistoryEntry(params: {
+  historyKey: string;
+  entry: HistoryEntry;
+  limit: number;
+  log?: (...args: any[]) => void;
+}): void {
+  const log = params.log ?? console.log;
+  if (params.limit <= 0) {
+    log(`[HISTORY record] 跳过: limit=${params.limit} historyKey=${params.historyKey}`);
+    return;
+  }
+  const history = chatHistories.get(params.historyKey) ?? [];
+  const beforeLen = history.length;
+  history.push(params.entry);
+  while (history.length > params.limit) {
+    history.shift();
+  }
+  // 刷新插入顺序（LRU）
+  if (chatHistories.has(params.historyKey)) {
+    chatHistories.delete(params.historyKey);
+  }
+  chatHistories.set(params.historyKey, history);
+  log(`[HISTORY record] historyKey=${params.historyKey} before=${beforeLen} after=${history.length} limit=${params.limit} sender=${params.entry.sender} msgId=${params.entry.messageId} body="${params.entry.body.slice(0, 80)}" totalKeys=${chatHistories.size}`);
+  // 超过最大 key 数量时淘汰最老的
+  if (chatHistories.size > MAX_HISTORY_KEYS) {
+    const keysToDelete = chatHistories.size - MAX_HISTORY_KEYS;
+    const iterator = chatHistories.keys();
+    for (let i = 0; i < keysToDelete; i++) {
+      const key = iterator.next().value;
+      if (key !== undefined) chatHistories.delete(key);
+    }
+    log(`[HISTORY evict] 淘汰了 ${keysToDelete} 个 key, 剩余 ${chatHistories.size}`);
+  }
+}
+
+function buildGroupHistoryContext(params: {
+  historyKey: string;
+  currentMessage: string;
+  formatEntry: (entry: HistoryEntry) => string;
+  log?: (...args: any[]) => void;
+}): string {
+  const log = params.log ?? console.log;
+  const entries = chatHistories.get(params.historyKey) ?? [];
+  log(`[HISTORY build] historyKey=${params.historyKey} entriesCount=${entries.length} currentMsgLen=${params.currentMessage.length}`);
+  if (entries.length === 0) {
+    log(`[HISTORY build] 无历史记录, 返回原始消息`);
+    return params.currentMessage;
+  }
+  for (let i = 0; i < entries.length; i++) {
+    log(`[HISTORY build] entry[${i}] sender=${entries[i].sender} msgId=${entries[i].messageId} body="${entries[i].body.slice(0, 80)}" ts=${entries[i].timestamp}`);
+  }
+  const historyText = entries.map(params.formatEntry).join("\n");
+  const combined = [
+    "[Chat messages since your last reply - for context]",
+    historyText,
+    "",
+    "[Current message - respond to this]",
+    params.currentMessage,
+  ].join("\n");
+  log(`[HISTORY build] 拼接完成: historyTextLen=${historyText.length} combinedLen=${combined.length}`);
+  return combined;
+}
+
+function clearGroupHistory(historyKey: string, log?: (...args: any[]) => void): void {
+  const _log = log ?? console.log;
+  const entries = chatHistories.get(historyKey) ?? [];
+  _log(`[HISTORY clear] historyKey=${historyKey} clearedEntries=${entries.length}`);
+  chatHistories.set(historyKey, []);
+}
+
 // ============ 媒体 payload 构建 ============
 
 function buildMediaPayload(
@@ -80,7 +165,10 @@ export async function handlePalzMessage(params: HandlePalzMessageParams): Promis
   const error = typeof runtime?.error === "function" ? runtime.error : console.error;
   const tag = `palz[${accountId}]`;
 
-  log(`${tag}: [STEP 1/6 入站过滤] msg_id=${msg.msg_id} sender=${msg.sender_id} conv=${msg.conversation_id}`);
+  const isGroup = msg.conversation_type === "group";
+  const effectiveAgentId = msg.agent_id || "main";
+
+  log(`${tag}: [STEP 1/6 入站过滤] msg_id=${msg.msg_id} sender=${msg.sender_id} conv=${msg.conversation_id} type=${msg.conversation_type} agent=${effectiveAgentId}`);
 
   const content = msg.content;
   if (!content) {
@@ -89,27 +177,52 @@ export async function handlePalzMessage(params: HandlePalzMessageParams): Promis
   }
 
   const plainText = extractPlainText(content).trim();
-  const hasImages =
-    Array.isArray(content) && content.some((p: ContentPart) => p.type === "image_url");
-  const imageCount = Array.isArray(content)
-    ? content.filter((p: ContentPart) => p.type === "image_url").length
+  const hasMedia =
+    Array.isArray(content) &&
+    content.some((p: ContentPart) => p.type === "file");
+  const mediaCount = Array.isArray(content)
+    ? content.filter((p: ContentPart) => p.type === "file").length
     : 0;
 
-  log(`${tag}: [STEP 1 解析] plainText="${plainText}" (len=${plainText.length}) hasImages=${hasImages} imageCount=${imageCount}`);
+  log(`${tag}: [STEP 1 解析] plainText="${plainText}" (len=${plainText.length}) hasMedia=${hasMedia} mediaCount=${mediaCount}`);
 
-  if (!plainText && !hasImages) {
-    log(`${tag}: [STEP 1 跳过] 原因=无文本且无图片`);
+  if (!plainText && !hasMedia) {
+    log(`${tag}: [STEP 1 跳过] 原因=无文本且无媒体`);
+    return;
+  }
+
+  // 群聊 @提及检测
+  const wasMentioned = isGroup ? (msg.mentioned_bot === true) : true;
+  if (isGroup && !wasMentioned) {
+    // 未@机器人：记录到群聊历史，下次被@时作为上下文
+    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}`);
+    recordGroupHistoryEntry({
+      historyKey,
+      entry: {
+        sender: msg.sender_id,
+        body: `${senderName}: ${plainText}`,
+        timestamp: Date.now(),
+        messageId: msg.msg_id,
+      },
+      limit: DEFAULT_GROUP_HISTORY_LIMIT,
+      log,
+    });
+    log(`${tag}: [STEP 1 跳过] 原因=群聊中未@机器人, 已记录到历史 historyKey=${historyKey}`);
     return;
   }
 
-  // 去重
-  const claimed = tryClaimMessage(msg.msg_id);
-  log(`${tag}: [STEP 2/6 去重] msg_id=${msg.msg_id} claimed=${claimed}`);
+  // 去重（按 agentId + conversationId 隔离，同群多 bot 场景）
+  const claimed = tryClaimMessage(msg.msg_id, effectiveAgentId, msg.conversation_id);
+  log(`${tag}: [STEP 2/6 去重] msg_id=${msg.msg_id} agent=${effectiveAgentId} conv=${msg.conversation_id} claimed=${claimed}`);
   if (!claimed) return;
 
-  // 入队
-  const queueKey = `${msg.sender_id}:${msg.conversation_id}`;
-  log(`${tag}: [STEP 3/6 入队] queueKey="${queueKey}"`);
+  // 入队（按 agentId 隔离，不同 agent 并行处理）
+  const queueKey = isGroup
+    ? `${effectiveAgentId}:${msg.conversation_id}`
+    : `${effectiveAgentId}:${msg.sender_id}:${msg.conversation_id}`;
+  log(`${tag}: [STEP 3/6 入队] queueKey="${queueKey}" isGroup=${isGroup}`);
 
   enqueue(queueKey, async () => {
     const startMs = Date.now();
@@ -130,24 +243,33 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
   const account = resolvePalzAccount({ cfg, accountId });
   const config = account.config;
 
+  const isGroup = msg.conversation_type === "group";
   const plainText = extractPlainText(msg.content).trim();
   const useStream = msg.stream === true;
-  const peerId = `${msg.sender_id}:${msg.conversation_id}`;
+  const senderName = msg.sender_name || msg.sender_id;
+
+  // 群聊：peerId = chat:conversation_id（整群共享 session，与 palzTo 格式一致）
+  // DM：peerId = sender_id:conversation_id（每用户每会话独立 session）
+  const peerId = isGroup ? `chat:${msg.conversation_id}` : `${msg.sender_id}:${msg.conversation_id}`;
 
   // STEP 4: 解析媒体
-  log(`${tag}: [STEP 4/6 媒体解析] 输入: contentType=${typeof msg.content === "string" ? "string" : "array"} imageCount=${Array.isArray(msg.content) ? msg.content.filter((p: ContentPart) => p.type === "image_url").length : 0}`);
+  const mediaCount = Array.isArray(msg.content)
+    ? msg.content.filter((p: ContentPart) => p.type === "file").length
+    : 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);
   log(`${tag}: [STEP 4 输出] mediaList=${JSON.stringify(mediaList.map((m) => ({ path: m.path, contentType: m.contentType })))} mediaPayload=${JSON.stringify(mediaPayload)}`);
 
   // STEP 5: 解析路由
-  const routeInput = { cfg: "(cfg)", channel: "palz-connector", accountId, peer: { kind: "direct", id: peerId } };
+  const peerKind = isGroup ? "group" : "direct";
+  const routeInput = { cfg: "(cfg)", channel: "palz-connector", accountId, peer: { kind: peerKind, id: peerId } };
   log(`${tag}: [STEP 5/6 路由解析] 输入: ${JSON.stringify(routeInput)} agent_id=${msg.agent_id ?? "(auto)"}`);
   const route = core.channel.routing.resolveAgentRoute({
     cfg,
     channel: "palz-connector",
     accountId,
-    peer: { kind: "direct", id: peerId },
+    peer: { kind: peerKind, id: peerId },
   });
 
   // IM 指定 agent_id 时走指定 agent，否则强制走 main
@@ -163,11 +285,13 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
 
   // STEP 6a: 构建 envelope body
   const envelopeOptions = core.channel.reply.resolveEnvelopeFormatOptions(cfg);
-  const messageBody = `${msg.sender_id}: ${plainText}`;
-  log(`${tag}: [STEP 6a/6 envelope构建] 输入: channel=Palz from=${msg.sender_id} messageBody="${messageBody.slice(0, 120)}" envelopeOptions=${JSON.stringify(envelopeOptions)}`);
+  const messageBody = `${senderName}: ${plainText}`;
+  // 群聊 from 带上 conversation_id 以区分不同用户
+  const envelopeFrom = isGroup ? `${msg.conversation_id}:${msg.sender_id}` : msg.sender_id;
+  log(`${tag}: [STEP 6a/6 envelope构建] 输入: channel=Palz from=${envelopeFrom} messageBody="${messageBody.slice(0, 120)}" envelopeOptions=${JSON.stringify(envelopeOptions)}`);
   const body = core.channel.reply.formatAgentEnvelope({
     channel: "Palz",
-    from: msg.sender_id,
+    from: envelopeFrom,
     timestamp: new Date(msg.timestamp || Date.now()),
     body: messageBody,
     envelope: envelopeOptions,
@@ -176,10 +300,11 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
 
   // STEP 6b: 构建 inbound context
   const palzFrom = `palz:${msg.sender_id}`;
-  const palzTo = `${msg.sender_id}:${msg.conversation_id}`;
+  // 群聊：To 指向群，DM：To 指向用户会话
+  const palzTo = isGroup ? `chat:${msg.conversation_id}` : `${msg.sender_id}:${msg.conversation_id}`;
 
-  // Palz DM 场景：检测是否包含斜杠命令，并计算命令授权。
-  // DM 用户默认视为已授权（与飞书插件 dmPolicy=open 时的行为一致）。
+  // 命令授权：DM 默认允许，群聊也默认允许（可后续扩展 allowlist）
+  const wasMentioned = isGroup ? (msg.mentioned_bot === true) : true;
   const needsCommandAuth = core.channel.commands.shouldComputeCommandAuthorized(plainText, cfg);
   const commandAuthorized = needsCommandAuth
     ? core.channel.commands.resolveCommandAuthorizedFromAuthorizers({
@@ -189,54 +314,71 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
     : undefined;
   log(`${tag}: [STEP 6b 命令授权] needsCommandAuth=${needsCommandAuth} commandAuthorized=${commandAuthorized}`);
 
-  const rawCtx = {
-    Body: `(envelope, len=${body.length})`,
-    BodyForAgent: messageBody.slice(0, 100),
-    RawBody: plainText.slice(0, 100),
-    CommandBody: plainText.slice(0, 100),
-    From: palzFrom,
-    To: palzTo,
-    SessionKey: route.sessionKey,
-    AccountId: route.accountId,
-    ChatType: "direct",
-    SenderId: msg.sender_id,
-    SenderName: msg.sender_id,
-    Provider: "palz-connector",
-    Surface: "palz-connector",
-    MessageSid: msg.msg_id,
-    Timestamp: Date.now(),
-    WasMentioned: true,
-    CommandAuthorized: commandAuthorized,
-    OriginatingChannel: "palz-connector",
-    OriginatingTo: palzTo,
-    ...mediaPayload,
-  };
-  log(`${tag}: [STEP 6b inbound context] 输入: ${JSON.stringify(rawCtx)}`);
+  const chatType = isGroup ? "group" : "direct";
+
+  // 群聊历史：将积攒的未@消息拼入 Body 上下文
+  const historyKey = isGroup ? `${effectiveAgentId}:${msg.conversation_id}` : undefined;
+  let combinedBody = body;
+  if (isGroup && historyKey) {
+    log(`${tag}: [STEP 6b 群聊历史] 开始构建, historyKey=${historyKey} bodyLen=${body.length}`);
+    combinedBody = buildGroupHistoryContext({
+      historyKey,
+      currentMessage: body,
+      formatEntry: (entry) =>
+        core.channel.reply.formatAgentEnvelope({
+          channel: "Palz",
+          from: entry.sender,
+          timestamp: new Date(entry.timestamp),
+          body: entry.body,
+          envelope: envelopeOptions,
+        }),
+      log,
+    });
+    log(`${tag}: [STEP 6b 群聊历史] 构建完成, historyKey=${historyKey} bodyLen=${body.length} combinedBodyLen=${combinedBody.length} hasHistory=${combinedBody.length !== body.length}`);
+    // log(`${tag}: [STEP 6b 群聊历史] combinedBody=\n${combinedBody}`);
+  }
+
+  // 构建 InboundHistory（结构化历史数据，Runtime 会注入到系统提示中）
+  const inboundHistory =
+    isGroup && historyKey
+      ? (chatHistories.get(historyKey) ?? []).map((entry) => ({
+          sender: entry.sender,
+          body: entry.body,
+          timestamp: entry.timestamp,
+        }))
+      : undefined;
+  log(`${tag}: [STEP 6b InboundHistory] count=${inboundHistory?.length ?? 0}`);
 
   const ctx = core.channel.reply.finalizeInboundContext({
-    Body: body,
+    Body: combinedBody,
     BodyForAgent: messageBody,
+    InboundHistory: inboundHistory,
     RawBody: plainText,
     CommandBody: plainText,
     From: palzFrom,
     To: palzTo,
     SessionKey: route.sessionKey,
     AccountId: route.accountId,
-    ChatType: "direct",
+    ChatType: chatType,
+    GroupSubject: isGroup ? msg.conversation_id : undefined,
     SenderId: msg.sender_id,
-    SenderName: msg.sender_id,
+    SenderName: senderName,
     Provider: "palz-connector",
     Surface: "palz-connector",
     MessageSid: msg.msg_id,
     Timestamp: Date.now(),
-    WasMentioned: true,
+    WasMentioned: wasMentioned,
     CommandAuthorized: commandAuthorized,
     OriginatingChannel: "palz-connector",
     OriginatingTo: palzTo,
     ...mediaPayload,
   });
   log(`${tag}: [STEP 6b 输出] finalized context keys=[${Object.keys(ctx).join(",")}] CommandAuthorized=${ctx.CommandAuthorized}`);
-
+  ctx.metadata = {
+    ...ctx.metadata,
+    traceId: msg.msg_id, 
+    source: "palz-connector"
+  };
   // STEP 6c: 创建回复分发器
   const dispatcherParams = {
     accountId,
@@ -261,6 +403,8 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
   });
 
   // STEP 6d: 分发消息给 AI
+  // channel registry 守卫已在 index.ts 中通过 defineProperty 安装，
+  // 每次读取 state.registry 时会自动注入 palz-connector channel。
   log(`${tag}: [STEP 6d AI分发] 开始 session=${route.sessionKey} stream=${useStream}`);
   const dispatchStartMs = Date.now();
 
@@ -276,6 +420,11 @@ async function dispatchPalzMessage(params: HandlePalzMessageParams): Promise<voi
       }),
   });
 
+  // AI 回复完成后清空群聊历史（已拼入上下文，避免下次重复）
+  if (isGroup && historyKey) {
+    clearGroupHistory(historyKey, log);
+  }
+
   const dispatchElapsedMs = Date.now() - dispatchStartMs;
   log(
     `${tag}: [STEP 6d 输出] queuedFinal=${queuedFinal} counts=${JSON.stringify(counts)} 耗时=${dispatchElapsedMs}ms`,

package/src/channel.ts

@@ -25,7 +25,7 @@ export const palzPlugin = {
   },
 
   capabilities: {
-    chatTypes: ["direct"],
+    chatTypes: ["direct", "channel"],
     polls: false,
     threads: false,
     media: true,

package/src/dedup.ts

@@ -1,7 +1,8 @@
 /**
  * 消息去重
  *
- * 基于 msg_id 防止重复处理，TTL 5 分钟。
+ * 基于 agentId + conversationId + msg_id 防止重复处理，TTL 5 分钟。
+ * 同一条消息可以被不同 agent 各自处理一次（同群多 bot 场景）。
  */
 
 const processedMessages = new Map<string, number>();
@@ -10,8 +11,8 @@ const MESSAGE_DEDUP_TTL = 5 * 60 * 1000;
 function cleanup(): void {
   const before = processedMessages.size;
   const now = Date.now();
-  for (const [msgId, ts] of processedMessages) {
-    if (now - ts > MESSAGE_DEDUP_TTL) processedMessages.delete(msgId);
+  for (const [key, ts] of processedMessages) {
+    if (now - ts > MESSAGE_DEDUP_TTL) processedMessages.delete(key);
   }
   console.log(`palz-dedup: cleanup ${before} → ${processedMessages.size} entries`);
 }
@@ -20,11 +21,15 @@ function cleanup(): void {
  * 尝试标记消息为已处理。
  * 返回 true 表示此消息之前未处理过（可以继续处理），
  * 返回 false 表示重复消息（应跳过）。
+ *
+ * agentId 用于同群多 bot 场景：同一条 msg_id 可被不同 agent 各自处理。
+ * conversationId 防止不同会话间 msg_id 碰撞导致误去重。
  */
-export function tryClaimMessage(msgId: string): boolean {
+export function tryClaimMessage(msgId: string, agentId: string = "main", conversationId: string = ""): boolean {
   if (!msgId) return true;
-  if (processedMessages.has(msgId)) return false;
-  processedMessages.set(msgId, Date.now());
+  const key = `${agentId}:${conversationId}:${msgId}`;
+  if (processedMessages.has(key)) return false;
+  processedMessages.set(key, Date.now());
   if (processedMessages.size >= 200) cleanup();
   return true;
 }

package/src/media.ts

@@ -1,22 +1,24 @@
 /**
  * Palz Connector 媒体处理
  *
- * 将 IM 消息中的图片上传到 OSS，返回公网 URL，
+ * 将 IM 消息中的图片/文件上传到 OSS，返回公网 URL，
  * 供 OpenClaw Runtime 作为媒体附件处理。
+ * 支持图片、PDF、DOCX、MD 等各类文件。
  */
 
 import fs from "fs";
 import path from "path";
 import os from "os";
-import type { OpenAIContent, ContentPart, ImageUrlContentPart, PalzMediaInfo } from "./types.js";
+import type {
+  OpenAIContent,
+  FileUrlContentPart,
+  PalzMediaInfo,
+} from "./types.js";
 import { uploadFileToOss, uploadBufferToOss } from "./oss.js";
 
 /** OpenClaw 允许访问的媒体目录 */
 const MEDIA_DIR = path.join(os.homedir(), ".openclaw", "media");
 
-/**
- * 将 Buffer 保存到 OpenClaw 媒体目录，返回 PalzMediaInfo。
- */
 function saveBufferToMediaDir(
   buffer: Buffer,
   contentType: string,
@@ -25,29 +27,123 @@ function saveBufferToMediaDir(
 ): PalzMediaInfo | null {
   try {
     fs.mkdirSync(MEDIA_DIR, { recursive: true });
-    const filePath = path.join(MEDIA_DIR, `palz_${Date.now()}_${Math.random().toString(36).slice(2, 8)}${ext}`);
+    const filePath = path.join(
+      MEDIA_DIR,
+      `palz_${Date.now()}_${Math.random().toString(36).slice(2, 8)}${ext}`,
+    );
     fs.writeFileSync(filePath, buffer);
-    log?.(`palz-media: [saveToMediaDir] 成功: path=${filePath} size=${buffer.length}bytes mime=${contentType}`);
-    return { path: filePath, contentType, placeholder: "<media:image>" };
+    const placeholder = isImageMime(contentType) ? "<media:image>" : `<media:file:${ext}>`;
+    log?.(
+      `palz-media: [saveToMediaDir] 成功: path=${filePath} size=${buffer.length}bytes mime=${contentType}`,
+    );
+    return { path: filePath, contentType, placeholder };
   } catch (err: any) {
     log?.(`palz-media: [saveToMediaDir] 失败: error=${err.message}`);
     return null;
   }
 }
 
+function isImageMime(mime: string): boolean {
+  return mime.startsWith("image/");
+}
+
+const MIME_TO_EXT: Record<string, string> = {
+  "image/jpeg": ".jpg",
+  "image/png": ".png",
+  "image/gif": ".gif",
+  "image/webp": ".webp",
+  "image/bmp": ".bmp",
+  "image/svg+xml": ".svg",
+  "application/pdf": ".pdf",
+  "application/msword": ".doc",
+  "application/vnd.openxmlformats-officedocument.wordprocessingml.document": ".docx",
+  "application/vnd.ms-excel": ".xls",
+  "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": ".xlsx",
+  "application/vnd.ms-powerpoint": ".ppt",
+  "application/vnd.openxmlformats-officedocument.presentationml.presentation": ".pptx",
+  "text/markdown": ".md",
+  "text/plain": ".txt",
+  "text/csv": ".csv",
+  "text/html": ".html",
+  "application/json": ".json",
+  "application/zip": ".zip",
+  "application/x-tar": ".tar",
+  "application/gzip": ".gz",
+  "audio/mpeg": ".mp3",
+  "audio/wav": ".wav",
+  "audio/ogg": ".ogg",
+  "video/mp4": ".mp4",
+  "video/webm": ".webm",
+  "application/octet-stream": ".bin",
+};
+
 function mimeToExt(mime: string): string {
-  const map: Record<string, string> = {
-    "image/jpeg": ".jpg",
-    "image/png": ".png",
-    "image/gif": ".gif",
-    "image/webp": ".webp",
-    "image/bmp": ".bmp",
-  };
-  return map[mime] || ".png";
+  return MIME_TO_EXT[mime] || ".bin";
+}
+
+function extFromUrl(url: string): string {
+  try {
+    const pathname = new URL(url).pathname;
+    const ext = path.extname(pathname).toLowerCase();
+    if (ext && ext.length <= 10) return ext;
+  } catch {}
+  return "";
+}
+
+function extToMime(ext: string): string {
+  for (const [mime, e] of Object.entries(MIME_TO_EXT)) {
+    if (e === ext) return mime;
+  }
+  return "application/octet-stream";
+}
+
+/**
+ * 从 URL 获取文件（data URL / HTTP URL），返回 buffer + contentType + ext。
+ */
+async function fetchUrlToBuffer(
+  url: string,
+  log?: (...args: any[]) => void,
+): Promise<{ buffer: Buffer; contentType: string; ext: string } | null> {
+  if (url.startsWith("data:")) {
+    const match = url.match(/^data:([^;]+);base64,(.+)$/);
+    if (!match) {
+      log?.(`palz-media: [fetchUrl] data URL 格式不匹配`);
+      return null;
+    }
+    const mimeType = match[1];
+    const base64Data = match[2];
+    const ext = mimeToExt(mimeType);
+    const buffer = Buffer.from(base64Data, "base64");
+    return { buffer, contentType: mimeType, ext };
+  }
+
+  if (url.startsWith("http://") || url.startsWith("https://")) {
+    try {
+      const resp = await fetch(url);
+      if (!resp.ok) {
+        log?.(`palz-media: [fetchUrl] HTTP下载失败: status=${resp.status}`);
+        return null;
+      }
+      const contentType =
+        resp.headers.get("content-type")?.split(";")[0]?.trim() || "application/octet-stream";
+      const buffer = Buffer.from(await resp.arrayBuffer());
+      const urlExt = extFromUrl(url);
+      const ext = urlExt || mimeToExt(contentType);
+      const finalContentType =
+        contentType === "application/octet-stream" && urlExt ? extToMime(urlExt) : contentType;
+      return { buffer, contentType: finalContentType, ext };
+    } catch (err: any) {
+      log?.(`palz-media: [fetchUrl] HTTP下载异常: ${err.message}`);
+      return null;
+    }
+  }
+
+  log?.(`palz-media: [fetchUrl] 无法识别的URL格式: ${url.slice(0, 200)}`);
+  return null;
 }
 
 /**
- * 从 OpenAI Content 中提取所有图片，上传到 OSS 并返回公网 URL。
+ * 从 OpenAI Content 中提取所有 type:"file" 媒体，下载并保存到本地。
  */
 export async function resolvePalzMediaList(
   content: OpenAIContent,
@@ -58,60 +154,53 @@ export async function resolvePalzMediaList(
     return [];
   }
 
-  const imageParts = content.filter((p: ContentPart): p is ImageUrlContentPart => p.type === "image_url" && (p as ImageUrlContentPart).image_url?.url !== undefined);
-  log?.(`palz-media: [resolve] 输入: parts=${content.length} imageParts=${imageParts.length}`);
+  const mediaUrls: string[] = [];
 
-  const results: PalzMediaInfo[] = [];
-  for (let i = 0; i < imageParts.length; i++) {
-    const part = imageParts[i];
-    const url = part.image_url!.url;
-    const urlType = url.startsWith("data:") ? "data-url" : url.startsWith("http") ? "http-url" : "unknown";
-    log?.(`palz-media: [resolve] 处理第 ${i + 1}/${imageParts.length} 个图片, type=${urlType} urlLen=${url.length}`);
-
-    let info: PalzMediaInfo | null = null;
-
-    if (url.startsWith("data:")) {
-      // data URL → 解码 → 保存到 OpenClaw 媒体目录
-      const match = url.match(/^data:(image\/[^;]+);base64,(.+)$/);
-      if (match) {
-        const mimeType = match[1];
-        const base64Data = match[2];
-        const ext = mimeToExt(mimeType);
-        const buffer = Buffer.from(base64Data, "base64");
-        info = saveBufferToMediaDir(buffer, mimeType, ext, log);
-      }
-    } else if (url.startsWith("http://") || url.startsWith("https://")) {
-      // HTTP URL → 下载 → 保存到 OpenClaw 媒体目录
-      try {
-        const resp = await fetch(url);
-        if (resp.ok) {
-          const contentType = resp.headers.get("content-type")?.split(";")[0]?.trim() || "image/png";
-          const buffer = Buffer.from(await resp.arrayBuffer());
-          const ext = mimeToExt(contentType);
-          info = saveBufferToMediaDir(buffer, contentType, ext, log);
-        } else {
-          log?.(`palz-media: [resolve] HTTP下载失败: status=${resp.status}`);
-        }
-      } catch (err: any) {
-        log?.(`palz-media: [resolve] HTTP下载异常: ${err.message}`);
+  for (const part of content) {
+    if (part.type === "file") {
+      const filePart = part as FileUrlContentPart;
+      if (filePart.file_url?.url) {
+        mediaUrls.push(filePart.file_url.url);
       }
     }
+  }
+
+  log?.(
+    `palz-media: [resolve] 输入: parts=${content.length} fileParts=${mediaUrls.length}`,
+  );
 
-    if (info) {
-      results.push(info);
-      log?.(`palz-media: [resolve] 第 ${i + 1} 完成: ${JSON.stringify(info)}`);
-    } else {
-      log?.(`palz-media: [resolve] 第 ${i + 1} 失败`);
+  const results: PalzMediaInfo[] = [];
+  for (let i = 0; i < mediaUrls.length; i++) {
+    const url = mediaUrls[i];
+    const urlType = url.startsWith("data:")
+      ? "data-url"
+      : url.startsWith("http")
+        ? "http-url"
+        : "unknown";
+    log?.(
+      `palz-media: [resolve] 处理第 ${i + 1}/${mediaUrls.length} 个媒体, urlType=${urlType} urlLen=${url.length}`,
+    );
+
+    const fetched = await fetchUrlToBuffer(url, log);
+    if (fetched) {
+      const info = saveBufferToMediaDir(fetched.buffer, fetched.contentType, fetched.ext, log);
+      if (info) {
+        results.push(info);
+        log?.(`palz-media: [resolve] 第 ${i + 1} 完成: ${JSON.stringify(info)}`);
+        continue;
+      }
     }
+    log?.(`palz-media: [resolve] 第 ${i + 1} 失败`);
   }
 
-  log?.(`palz-media: [resolve] 输出: 共解析 ${results.length}/${imageParts.length} 个媒体文件`);
+  log?.(
+    `palz-media: [resolve] 输出: 共解析 ${results.length}/${mediaUrls.length} 个媒体文件`,
+  );
   return results;
 }
 
 /**
  * 将本地文件路径、data URL 或 HTTP URL 转为 OSS 公网链接（用于出站消息）。
- * 替代 loadMediaAsDataUrl，避免 base64 传输。
  */
 export async function loadMediaAsOssUrl(
   mediaUrl: string,
@@ -119,15 +208,17 @@ export async function loadMediaAsOssUrl(
 ): Promise<string | null> {
   log?.(`palz-media: [loadAsOssUrl] 输入: url=${mediaUrl.slice(0, 200)}`);
 
-  // 已经是 OSS 链接，直接返回
-  if (mediaUrl.startsWith("https://oss.csaiagent.com/") || mediaUrl.startsWith("https://cstv-data.oss-cn-beijing.aliyuncs.com/")) {
+  if (
+    mediaUrl.startsWith("https://oss.csaiagent.com/") ||
+    mediaUrl.startsWith("https://cstv-data.oss-cn-beijing.aliyuncs.com/")
+  ) {
     log?.(`palz-media: [loadAsOssUrl] 已是OSS链接, 直接返回`);
     return mediaUrl;
   }
 
   // data URL → 解码 → 上传到 OSS
   if (mediaUrl.startsWith("data:")) {
-    const match = mediaUrl.match(/^data:(image\/[^;]+);base64,(.+)$/);
+    const match = mediaUrl.match(/^data:([^;]+);base64,(.+)$/);
     if (!match) {
       log?.(`palz-media: [loadAsOssUrl] data URL 格式不匹配`);
       return null;
@@ -138,7 +229,9 @@ export async function loadMediaAsOssUrl(
     try {
       const buffer = Buffer.from(base64Data, "base64");
       const ossUrl = await uploadBufferToOss(buffer, ext, log);
-      log?.(`palz-media: [loadAsOssUrl] data URL → OSS: mime=${mimeType} bufSize=${buffer.length} ossUrl=${ossUrl}`);
+      log?.(
+        `palz-media: [loadAsOssUrl] data URL → OSS: mime=${mimeType} bufSize=${buffer.length} ossUrl=${ossUrl}`,
+      );
       return ossUrl;
     } catch (err: any) {
       log?.(`palz-media: [loadAsOssUrl] data URL上传OSS失败: ${err.message}`);
@@ -148,14 +241,25 @@ export async function loadMediaAsOssUrl(
 
   // 本地文件路径（绝对或相对）→ 上传到 OSS
   const rawPath = mediaUrl.replace(/^MEDIA:/, "");
-  const filePath = path.isAbsolute(rawPath) ? rawPath : path.resolve(rawPath);
+  let filePath = path.isAbsolute(rawPath) ? rawPath : path.resolve(rawPath);
+  if (!fs.existsSync(filePath)) {
+    const fallback = path.join(MEDIA_DIR, path.basename(filePath));
+    if (fs.existsSync(fallback)) {
+      log?.(`palz-media: [loadAsOssUrl] 路径fallback: ${filePath} → ${fallback}`);
+      filePath = fallback;
+    }
+  }
   if (fs.existsSync(filePath)) {
     try {
       const ossUrl = await uploadFileToOss(filePath, log);
-      log?.(`palz-media: [loadAsOssUrl] 本地文件 → OSS: path=${filePath} ossUrl=${ossUrl}`);
+      log?.(
+        `palz-media: [loadAsOssUrl] 本地文件 → OSS: path=${filePath} ossUrl=${ossUrl}`,
+      );
       return ossUrl;
     } catch (err: any) {
-      log?.(`palz-media: [loadAsOssUrl] 本地文件上传OSS失败: ${filePath} error=${err.message}`);
+      log?.(
+        `palz-media: [loadAsOssUrl] 本地文件上传OSS失败: ${filePath} error=${err.message}`,
+      );
       return null;
     }
   }
@@ -168,11 +272,15 @@ export async function loadMediaAsOssUrl(
         log?.(`palz-media: [loadAsOssUrl] HTTP下载失败: status=${resp.status}`);
         return null;
       }
-      const contentType = resp.headers.get("content-type")?.split(";")[0]?.trim() || "image/png";
+      const contentType =
+        resp.headers.get("content-type")?.split(";")[0]?.trim() || "application/octet-stream";
       const buffer = Buffer.from(await resp.arrayBuffer());
-      const ext = mimeToExt(contentType);
+      const urlExt = extFromUrl(mediaUrl);
+      const ext = urlExt || mimeToExt(contentType);
       const ossUrl = await uploadBufferToOss(buffer, ext, log);
-      log?.(`palz-media: [loadAsOssUrl] HTTP → OSS: size=${buffer.length} mime=${contentType} ossUrl=${ossUrl}`);
+      log?.(
+        `palz-media: [loadAsOssUrl] HTTP → OSS: size=${buffer.length} mime=${contentType} ossUrl=${ossUrl}`,
+      );
       return ossUrl;
     } catch (err: any) {
       log?.(`palz-media: [loadAsOssUrl] HTTP下载上传OSS异常: ${err.message}`);

package/src/outbound.ts

@@ -20,14 +20,15 @@ export const palzOutbound = {
     log(`palz-outbound: [sendText] 输入: to="${to}" accountId="${accountId}" textLen=${text?.length || 0} text="${(text || "").slice(0, 120)}"`);
 
     const account = resolvePalzAccount({ cfg, accountId });
-    const { senderId, conversationId } = parsePalzTarget(to);
-    log(`palz-outbound: [sendText] 解析: senderId="${senderId}" conversationId="${conversationId}" botId=${account.config.botId}`);
+    const { senderId, conversationId, conversationType } = parsePalzTarget(to);
+    log(`palz-outbound: [sendText] 解析: senderId="${senderId}" conversationId="${conversationId}" conversationType="${conversationType}" botId=${account.config.botId}`);
 
     const result = await sendToPalzIM({
       config: account.config,
       conversationId,
       content: text,
       senderId,
+      conversationType,
     });
 
     const output = { channel: "palz-connector", messageId: Date.now().toString() };
@@ -38,11 +39,11 @@ export const palzOutbound = {
   sendMedia: async (ctx: any) => {
     const { cfg, to, text, mediaUrl, accountId } = ctx;
     const log = typeof ctx.log === "function" ? ctx.log : console.log;
-    log(`palz-outbound: [sendMedia] 输入: to="${to}" accountId="${accountId}" textLen=${text?.length || 0} mediaUrl="${(mediaUrl || "").slice(0, 200)}"`);
 
     const account = resolvePalzAccount({ cfg, accountId });
-    const { senderId, conversationId } = parsePalzTarget(to);
-    log(`palz-outbound: [sendMedia] 解析: senderId="${senderId}" conversationId="${conversationId}" botId=${account.config.botId}`);
+    const { senderId, conversationId, conversationType } = parsePalzTarget(to);
+    log(`palz-outbound: [sendMedia] 输入: to="${to}" accountId="${accountId}" textLen=${text?.length || 0} mediaUrl="${(mediaUrl || "").slice(0, 200)}"`);
+    log(`palz-outbound: [sendMedia] 解析: senderId="${senderId}" conversationId="${conversationId}" conversationType="${conversationType}" botId=${account.config.botId}`);
 
     const contentParts: ContentPart[] = [];
 
@@ -53,7 +54,7 @@ export const palzOutbound = {
     if (mediaUrl) {
       const ossUrl = await loadMediaAsOssUrl(mediaUrl, log);
       if (ossUrl) {
-        contentParts.push({ type: "image_url", image_url: { url: ossUrl } });
+        contentParts.push({ type: "file", file_url: { url: ossUrl } });
         log(`palz-outbound: [sendMedia] 媒体转换成功: ossUrl=${ossUrl}`);
       } else {
         contentParts.push({ type: "text", text: `\n📎 ${mediaUrl}` });
@@ -73,6 +74,7 @@ export const palzOutbound = {
       conversationId,
       content,
       senderId,
+      conversationType,
     });
 
     const output = { channel: "palz-connector", messageId: Date.now().toString() };

package/src/reply-dispatcher.ts

@@ -121,7 +121,7 @@ export function createPalzReplyDispatcher(params: CreatePalzReplyDispatcherParam
           log(`${tag}: [DELIVER 媒体] ${i + 1}/${mediaUrls.length} url=${mediaUrls[i].slice(0, 200)}`);
           const ossUrl = await loadMediaAsOssUrl(mediaUrls[i], log);
           if (ossUrl) {
-            contentParts.push({ type: "image_url", image_url: { url: ossUrl } });
+            contentParts.push({ type: "file", file_url: { url: ossUrl } });
             log(`${tag}: [DELIVER 媒体转换成功] ${i + 1}/${mediaUrls.length} ossUrl=${ossUrl}`);
           } else {
             contentParts.push({ type: "text", text: `\n📎 ${mediaUrls[i]}` });

package/src/targets.ts

@@ -11,23 +11,31 @@ export function normalizePalzTarget(raw: string): string | undefined {
 
 export function looksLikePalzId(raw: string): boolean {
   const trimmed = raw.trim().replace(/^(palz-connector|palz):/i, "");
-  return /^[\w:._-]+$/.test(trimmed);
+  return /^[\p{L}\p{N}\w:._-]+$/u.test(trimmed);
 }
 
 /**
  * 从 "to" 地址中解析出 senderId 和 conversationId。
- * 格式: "{senderId}:{conversationId}"
+ * 格式:
+ *   DM:    "{senderId}:{conversationId}"
+ *   群聊:  "chat:{conversationId}"（senderId 为空，群消息不需要指定 senderId）
  */
 export function parsePalzTarget(to: string): {
   senderId?: string;
   conversationId: string;
+  conversationType: string;
 } {
+  // 群聊目标：chat:xxx → senderId 留空
+  if (to.startsWith("chat:")) {
+    return { conversationId: to.slice(5), conversationType: "group" };
+  }
   const parts = to.split(":");
   if (parts.length >= 2) {
     return {
       senderId: parts[0],
       conversationId: parts.slice(1).join(":"),
+      conversationType: "direct",
     };
   }
-  return { conversationId: to };
+  return { conversationId: to, conversationType: "direct" };
 }

package/src/types.ts

@@ -5,11 +5,11 @@
 // ============ IM 消息格式（OpenAI Content 协议） ============
 
 export type TextContentPart = { type: "text"; text: string };
-export type ImageUrlContentPart = {
-  type: "image_url";
-  image_url: { url: string; detail?: string };
+export type FileUrlContentPart = {
+  type: "file";
+  file_url: { url: string };
 };
-export type ContentPart = TextContentPart | ImageUrlContentPart;
+export type ContentPart = TextContentPart | FileUrlContentPart;
 export type OpenAIContent = string | ContentPart[];
 
 // ============ Palz IM 消息事件 ============
@@ -17,6 +17,7 @@ export type OpenAIContent = string | ContentPart[];
 export interface PalzMessageEvent {
   event: string;
   sender_id: string;
+  sender_name?: string;
   receiver_id: string;
   conversation_id: string;
   conversation_type: string;
@@ -26,6 +27,8 @@ export interface PalzMessageEvent {
   timestamp: number;
   /** 可选，指定 OpenClaw agent ID，覆盖默认路由 */
   agent_id?: string;
+  /** 群聊中是否 @了机器人 */
+  mentioned_bot?: boolean;
 }
 
 // ============ 配置 ============