openclaw-zalo-mod 2.30.0 → 2.31.1

package/README.md

@@ -4,7 +4,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![OpenClaw Plugin](https://img.shields.io/badge/OpenClaw-Plugin-blue.svg)](https://openclaw.ai)
-[![Version](https://img.shields.io/badge/version-2.30.0-green.svg)](./CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.31.1-green.svg)](./CHANGELOG.md)
 
 **[🇺🇸 English](./README.md)**
 

package/README.vi.md

@@ -4,7 +4,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![OpenClaw Plugin](https://img.shields.io/badge/OpenClaw-Plugin-blue.svg)](https://openclaw.ai)
-[![Version](https://img.shields.io/badge/version-2.30.0-green.svg)](./CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.31.1-green.svg)](./CHANGELOG.md)
 
 **[🇺🇸 English](./README.md)**
 

package/dashboard.js

@@ -10,7 +10,7 @@ const modalBody = document.getElementById('modalBody');
 const modalCancel = document.getElementById('modalCancel');
 const modalConfirm = document.getElementById('modalConfirm');
 const token = window.ZALO_DASHBOARD_TOKEN || '';
-const pluginVersion = '2.30.0';
+const pluginVersion = '2.31.1';
 let state = null;
 let activeGroupId = '';
 let lang = localStorage.getItem('zaloDashboardLang') || 'vi';
@@ -169,6 +169,24 @@ function setSection(id) {
   if (id === 'contacts') renderCrmContacts();
   if (id === 'leads') renderCrmLeads();
   if (id === 'tasks') renderCrmTasks();
+  // Trang đọc từ `state` cache trong trình duyệt — nhưng dữ liệu phía server có thể đã đổi mà
+  // KHÔNG đi qua tab này: owner nhắn "đồng bộ nhóm" là agent chạy sync-groups qua zalo_mod_action
+  // (cùng handler với nút UI). Đo thật 30/08/2026 trên bot "Em Mơ": server/API trả 15 nhóm mà tab
+  // mở sẵn vẫn vẽ 9 nhóm cũ — nhìn y như "đồng bộ không ăn". Refetch NỀN khi mở các trang
+  // state-driven; loadState() tự kết thúc bằng renderState() nên gọi là đủ. Chỉ các trang này —
+  // trang on-demand (chat, journal…) không refetch kẻo re-render nuốt nội dung đang gõ.
+  if (id === 'groups' || id === 'overview' || id === 'members') refreshStateQuiet();
+}
+
+// Refetch state ở nền khi chuyển trang. Cờ in-flight để bấm qua lại nhanh không dồn request;
+// lỗi mạng nuốt im — chuyển trang không được nổ toast vì một lần refetch nền hỏng.
+let _stateRefreshQuietInFlight = false;
+function refreshStateQuiet() {
+  if (_stateRefreshQuietInFlight) return;
+  _stateRefreshQuietInFlight = true;
+  loadState()
+    .catch(() => {})
+    .finally(() => { _stateRefreshQuietInFlight = false; });
 }
 // Re-render whichever on-demand section is currently active (these render on
 // tab-open via setSection, not inside renderState). Called when the selected bot
@@ -7047,7 +7065,9 @@ function chatMsgHtml(m, { isGroup, lastDay, isNew = false }) {
   const html = `${sep}<div class="chat-msg${m.fromSelf ? ' me' : ''}${isNew ? ' chat-msg-new' : ''}" data-msg-id="${crmEsc(m.id)}">
     ${/* Tên người gửi chỉ có nghĩa trong nhóm — DM thì hai bên đã rõ, in thêm chỉ tổ rối. */''}
     ${isGroup && !m.fromSelf ? `<div class="chat-msg-who">${crmEsc(m.senderName || m.senderId)}</div>` : ''}
-    <div class="chat-bubble">${media}${crmEsc(m.text || '')}</div>
+    ${/* Co anh roi thi khong in kem chu "[Media attachment]" — day la chu do host sinh ra khi
+         tin khong co phan chu, giu lai chi lam bong bong roi. */''}
+    <div class="chat-bubble">${media}${crmEsc(media && /^\[(media|file|image|sticker)[^\]]*\]$/i.test((m.text || '').trim()) ? '' : (m.text || ''))}</div>
     <div class="chat-msg-time">${chatTime(m.sentAt)}</div>
   </div>`;
   return { html, day };

package/index.html

@@ -127,7 +127,7 @@
             log.</span>
         </div>
         <div class="plugin-meta">
-          <strong>zalo-mod <span id="pluginVersion">v2.30.0</span></strong>
+          <strong>zalo-mod <span id="pluginVersion">v2.31.1</span></strong>
           <span>Được làm ❤️ bởi tuanminhole</span>
           <div class="socials" aria-label="Author links">
             <a href="https://www.facebook.com/holeminhtuan.it/" target="_blank" rel="noreferrer"

package/index.js

@@ -25,6 +25,7 @@ import http from 'node:http';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { definePluginEntry } from 'openclaw/plugin-sdk/plugin-entry';
+import { ghepLaiMedia } from './src/storage/media-backfill.js';
 import { createZaloModEngine } from './src/integration/zalo-mod-engine.js';
 import { handleCrmAction } from './src/crm/crm-api.js';
 import { buildZaloPeople } from './src/crm/zalo-people.js';
@@ -205,6 +206,15 @@ function foldText(value) {
         .trim();
 }
 
+function isAddressedByBareName(foldedContent, foldedName) {
+    // Khop TEN TRAN (khong co '@') co RANH GIOI TU, tren chuoi da bo dau + thuong hoa.
+    // Cung ngu nghia voi textMentionsAnyName cua zalo-connect, de hai tang khong lech nhau.
+    // Ten < 2 ky tu bi bo: qua ngan thi khop nham nhieu hon la trung.
+    if (!foldedName || foldedName.length < 2) return false;
+    const escaped = foldedName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`(^|[^\\p{L}\\p{N}])${escaped}([^\\p{L}\\p{N}]|$)`, 'u').test(foldedContent);
+}
+
 async function safeReadJson(filePath) {
     try {
         const raw = await fs.readFile(filePath, 'utf8');
@@ -475,6 +485,17 @@ async function getTemplateContent(filePath, defaultContent) {
     return defaultContent;
 }
 
+// Tên bot HIỂN THỊ phải theo tên Zalo THẬT đang đăng nhập (bridge trả displayName khi replay/set
+// name-trigger, được ghi vào globalThis.__zaloModLiveBotNames). pluginCfg.botName là cấu hình tĩnh:
+// tài khoản đổi tên Zalo thì template ({botName}, @{botName} trong welcome) vẫn in tên cũ và dạy
+// thành viên tag một cái tên không còn tag được. Đo 31/08/2026: welcome in "@Em Mơ" trong khi tên
+// thật đã là "Em Mơ Trợ Lí".
+function liveBotName(profile, fallback) {
+    const map = globalThis.__zaloModLiveBotNames || {};
+    const key = String(profile || 'default').split(',')[0].trim() || 'default';
+    return String(map[key] || '').trim() || fallback;
+}
+
 function renderTemplate(templateStr, vars) {
     let result = String(templateStr || '');
     for (const [key, value] of Object.entries(vars)) {
@@ -571,14 +592,40 @@ function isMessageMentioningBot(event, botNames, profileName) {
                 searchNames = [liveName, ...liveZaloNames].filter(Boolean);
             }
         }
+
+        // ── Ten goi do DASHBOARD luu nam o STORE KHAC ────────────────────────────────────
+        // Hop thoai "Che do Im lang — ten goi bot" luu qua persistNameTriggers(), ma ham do ghi
+        // vao settings.json (`global.nameTriggersByAccount`) — KHONG phai config.json ma doan tren
+        // vua doc. Thieu doan nay thi moi ten them tu hop thoai deu VO HINH voi tang nay:
+        // zalo-connect nhan duoc (bridge replay doc settings.json) nen cho qua cong cua no, roi
+        // den day bi chan — nhin tu ngoai la "da luu ma bot van khong tra loi".
+        // Do that 30/08/2026: settings.json co ["Mơ ơi","Em Mơ","trợ lý mơ","trợ lí mơ"] trong khi
+        // config.json van la danh sach cu ⇒ goi "trợ lý mơ" bot im.
+        for (const dp of dataPaths) {
+            const settingsPath = path.join(path.dirname(dp), 'settings.json');
+            if (!existsSync(settingsPath)) continue;
+            const settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+            const byAccount = settings?.global?.nameTriggersByAccount || {};
+            const saved = byAccount[profileName || 'default'] || byAccount.default || [];
+            if (Array.isArray(saved) && saved.length) {
+                searchNames = [...searchNames, ...saved.map(String)].filter(Boolean);
+            }
+            break;
+        }
     } catch (e) { }
 
     // Check all known bot names/aliases
+    const foldedContent = foldText(content);
     for (const raw of searchNames) {
         const name = String(raw || '').toLowerCase().trim();
         if (!name) continue;
         const folded = foldText(name);
         if (content.includes(`@${name}`) || content.includes(`@${folded}`)) return true;
+        // Goi TEN TRAN (khong co '@') — dung tinh nang "Im lang: bot tra loi khi goi dung ten bot"
+        // ma dashboard hua. zalo-connect DA cho qua cong cua no (do that 30/08/2026:
+        // wasNamed=true, skip=false) nhung o day van doi '@' nen tin rot lai va KHONG de lai
+        // log nao — nhin tu ngoai chi thay bot tha tim roi im.
+        if (isAddressedByBareName(foldedContent, folded)) return true;
     }
     // OpenClaw native mention flag
     if (event.wasMentioned === true) return true;
@@ -2545,7 +2592,7 @@ Quy tắc:
                 try {
                     const botCfg = getBotConfig(groupId);
                     const welcomeTpl = await loadTemplateContent(dataDir, 'welcome');
-                    const welcomeText = renderTemplate(welcomeTpl, { memberName, groupName: getGroupName(groupId), botName: botCfg.botName, cmdPrefix: botCfg.cmdPrefix });
+                    const welcomeText = renderTemplate(welcomeTpl, { memberName, groupName: getGroupName(groupId), botName: liveBotName(botCfg.profile, botCfg.botName), cmdPrefix: botCfg.cmdPrefix });
                     await sendGroupMsg({ accountId: botCfg.profile }, groupId, welcomeText);
                     await appendToMemoryFile(groupId, 'chat-highlights.md', `| ${nowShort()} | SYSTEM | Welcome: ${memberName} joined (detected by watcher) |`);
                     logger.info(`[openclaw-zalo-mod] [WATCHER] welcome sent for ${memberName} in group ${groupId}`);
@@ -4246,7 +4293,13 @@ Quy tắc:
             const map = readTriggerMap();
             let applied = 0;
             for (const [accountId, list] of Object.entries(map)) {
-                try { await bridge.setNameTriggers(accountId, Array.isArray(list) ? list : []); applied++; }
+                try {
+                    const runtime = await bridge.setNameTriggers(accountId, Array.isArray(list) ? list : []);
+                    applied++;
+                    // Bridge trả kèm tên Zalo THẬT — nguồn duy nhất luôn đúng sau khi đổi tên.
+                    const dn = String(runtime?.displayName || '').trim();
+                    if (dn) (globalThis.__zaloModLiveBotNames ||= {})[accountId] = dn;
+                }
                 catch (e) { logger.warn(`[openclaw-zalo-mod] name-trigger replay ${accountId}: ${e.message}`); }
             }
             return { applied, total: Object.keys(map).length };
@@ -5568,7 +5621,11 @@ Quy tắc:
                 const bridge = globalThis.__zaloModEngine?.bridge;
                 let runtime = null;
                 if (bridge?.setNameTriggers) {
-                    try { runtime = await bridge.setNameTriggers(accountId, input); }
+                    try {
+                        runtime = await bridge.setNameTriggers(accountId, input);
+                        const dn = String(runtime?.displayName || '').trim();
+                        if (dn) (globalThis.__zaloModLiveBotNames ||= {})[accountId] = dn;
+                    }
                     catch (e) { logger.warn(`[openclaw-zalo-mod] set-name-triggers ${accountId}: ${e.message}`); }
                 }
                 // Persist the runtime-cleaned list when available so store and runtime match.
@@ -5828,6 +5885,23 @@ Quy tắc:
             // sử kéo về), nên mở khung chat không tốn một lượt gọi mạng nào và không đụng hạn mức
             // của Zalo. Đổi lại: chỉ thấy được những gì đã đồng bộ — nên phần mô tả trang nói thẳng
             // là lịch sử về khi bấm Sync account.
+            // Ghep lai anh cu voi tin da mat link (P17). Chay duoc nhieu lan: `setMessageMedia`
+            // chi ghi khi media_json con NULL nen khong bao gio de len du lieu dung.
+            // `dryRun: true` de xem truoc se ghep bao nhieu ma khong sua gi.
+            if (action === 'chat-backfill-media') {
+                const store = zEngine?.storage;
+                if (!store?.messagesWithoutMedia) throw new Error('Ghep lai anh can SQLite (Node >= 22.5).');
+                const kq = ghepLaiMedia(store, _openclawHome, {
+                    toleranceMs: Math.min(Number(payload.toleranceMs) || 5000, 60000),
+                    limit: Math.min(Number(payload.limit) || 5000, 20000),
+                    dryRun: payload.dryRun === true,
+                });
+                logger.info(`[openclaw-zalo-mod] ghep lai anh: quet ${kq.quet} tin, ghep ${kq.ghep}`
+                    + `, bo qua nhap nhang ${kq.boQuaNhapNhang}, khong co tep ${kq.khongCo}`
+                    + (payload.dryRun === true ? ' (xem truoc, chua ghi)' : ''));
+                return kq;
+            }
+
             if (action === 'chat-conversations' || action === 'chat-messages' || action === 'chat-version') {
                 const store = zEngine?.storage;
                 if (!store?.listConversations) throw new Error('Khung chat cần SQLite (Node >= 22.5).');
@@ -6312,6 +6386,49 @@ Quy tắc:
                         return;
                     }
 
+                    // ── Anh/tep dinh kem da tai ve (P17) ──
+                    //
+                    // OpenClaw tai san media ve `<home>/.openclaw/media/{inbound,outbound}`. Khung chat
+                    // can mot URL de dat vao <img src>, ma duong dan tren dia thi trinh duyet khong mo
+                    // duoc — nen phuc vu qua chinh dashboard. Khong doi token, GIONG logo/QR: dashboard
+                    // chi bind 127.0.0.1 va vao qua duong ham SSH; hon nua <img src> KHONG gui duoc
+                    // header Authorization nen bat token o day la tu khoa cua mo anh.
+                    //
+                    // Chan duong vong: chi nhan DUNG mot ten tep (khong thu muc con), loai bo moi thu
+                    // co '/', '\\' hay '..', roi doi soat lai bang path.resolve — vao duoc ngoai thu muc
+                    // media la tu choi. Chi phuc vu duoi tep da biet.
+                    if (req.method === 'GET' && url.pathname.startsWith('/media/')) {
+                        const parts = url.pathname.split('/').filter(Boolean);   // ['media', kind, name]
+                        const kind = parts[1];
+                        const name = decodeURIComponent(parts[2] || '');
+                        const MIME = {
+                            '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg', '.png': 'image/png',
+                            '.gif': 'image/gif', '.webp': 'image/webp', '.mp4': 'video/mp4',
+                            '.pdf': 'application/pdf',
+                        };
+                        const ext = path.extname(name).toLowerCase();
+                        const hopLe = parts.length === 3
+                            && (kind === 'inbound' || kind === 'outbound')
+                            && name && !name.includes('/') && !name.includes('\\') && !name.includes('..')
+                            && Object.prototype.hasOwnProperty.call(MIME, ext);
+                        if (!hopLe) {
+                            sendDashboardJson(res, 400, { ok: false, error: 'Media path khong hop le' });
+                            return;
+                        }
+                        const goc = path.resolve(_openclawHome, '.openclaw', 'media', kind);
+                        const tep = path.resolve(goc, name);
+                        if (!tep.startsWith(goc + path.sep) || !existsSync(tep)) {
+                            sendDashboardJson(res, 404, { ok: false, error: 'Media not found' });
+                            return;
+                        }
+                        res.writeHead(200, {
+                            'content-type': MIME[ext],
+                            'cache-control': 'private, max-age=86400',
+                        });
+                        res.end(readFileSync(tep));
+                        return;
+                    }
+
                     if (req.method === 'GET' && (url.pathname === '/assets/logo.png' || url.pathname === '/logo.png' || url.pathname === '/favicon.ico')) {
                         if (!existsSync(logoFile)) {
                             sendDashboardJson(res, 404, { ok: false, error: 'Logo not found' });
@@ -6657,7 +6774,22 @@ Quy tắc:
             } catch (_) { /* not JSON, normal text — continue */ }
 
             const rawConvId = String(ctx.conversationId || event.conversationId || '');
-            const isGroupMsg = rawConvId.startsWith('group:');
+            // ── Nhan biet NHOM vs DM — do that, khong suy tu hop dong ──────────────────────
+            // Tren hook `before_dispatch`, tin NHOM den duoi dang:
+            //     conversationId = "'zalo-connect':<GROUP_ID>"   (KHONG co tien to `group:`)
+            //     event.isGroup  = false                          (openclaw bao SAI)
+            // Do that tren bot "Em Mo" 30/08/2026, cung dang voi DM (`'zalo-connect':<USER_ID>`),
+            // nen KHONG co cach nao phan biet bang hinh dang chuoi. Hau qua neu doan sai: moi tin
+            // nhom roi vao nhanh DM ben duoi ⇒ `permissions.dm.mode="owner"` khoa luon ca nhom,
+            // ngoai owner ra khong ai noi duoc voi bot o BAT KY dau, du nhom da tick trong Quyen
+            // Group. Tin bi `handled:true` nuot mat, khong de lai dau vet trong log zalo-connect.
+            // Nguon tin cay duy nhat: SO NHOM cua chinh plugin (`groupNames`, tra qua
+            // plainGroupId). Duoi id lay sau dau ':' cuoi vi tien to la ten kenh co nhay don.
+            const convTailId = rawConvId.replace(/^.*:/, '').trim();
+            const knownGroupId = plainGroupId(rawConvId, convTailId);
+            const isGroupMsg = event?.isGroup === true
+                || rawConvId.startsWith('group:')
+                || !!knownGroupId;
             const senderId = String(ctx.senderId || event.senderId || '');
             // Group event thường KHÔNG kèm tên hiển thị → thử các field rẻ trước, resolve qua API sau (bên dưới).
             let senderName = String(event.senderName || event.sender?.name || event.dName || event.data?.dName || '').trim() || senderId;
@@ -6666,7 +6798,10 @@ Quy tắc:
             // profile ghi nhận của group. Nhờ vậy mỗi bot trong group nhiều bot sẽ
             // dùng đúng tên/prefix/owner của chính nó (check @mention, slash, owner...).
             const botCfg = getBotConfig(ctx?.accountId || (isGroupMsg ? rawConvId : 'default'));
-            const { profile, botName, botNames, cmdPrefix, ownerId: activeOwnerId } = botCfg;
+            const { profile, botName: cfgBotName, botNames, cmdPrefix, ownerId: activeOwnerId } = botCfg;
+            // Moi cho hien thi ten bot trong handler nay (template, menu owner, DM…) dung ten
+            // Zalo THAT; cau hinh tinh chi con la fallback khi bridge chua tra displayName.
+            const botName = liveBotName(profile, cfgBotName);
             const currentOwnerId = activeOwnerId || (profile === 'default' ? ownerId : '');
 
             // Tên hiển thị: nếu event không kèm tên (senderName == id) → resolve qua API bot nhận tin (có cache).
@@ -6813,10 +6948,25 @@ Quy tắc:
                 return { handled: true };
             }
 
-            const groupId = rawConvId.replace(/^group:/, '');
+            // rawConvId co the la "'zalo-connect':<id>" nen khong the chi cat tien to `group:`
+            // — cat vay se ra chuoi rac va `isGroupAllowed()` ben duoi luon truot.
+            const groupId = knownGroupId || rawConvId.replace(/^group:/, '');
 
             // ── GROUP ACCESS GATE — bot chỉ hoạt động ở group được phép (owner luôn lọt) ──
-            if (!isGroupAllowed(groupId) && senderId !== currentOwnerId) return { handled: true };
+            if (!isGroupAllowed(groupId) && senderId !== currentOwnerId) {
+                // Ngoại lệ NHỎ: lệnh TEMPLATE tĩnh vẫn trả lời được. Welcome/follow là toggle theo
+                // nhóm, ĐỘC LẬP với allowList Quyền Group — nên chính bot vẫn gửi welcome dạy
+                // "/bot-noi-quy", "/bot-menu" vào nhóm chưa tick, thành viên bấm theo mà bot im thì
+                // như bot hỏng (đo 31/08/2026, nhóm "Kinh Doanh Một Người Với AI"). Chỉ mở template:
+                // text tĩnh, zero-token, không LLM, không đổi cấu hình; mọi thứ khác chặn như cũ.
+                const _m = String(content || '').match(/(?:^|\s)(\/[a-z][a-z0-9-]*)/i);
+                const _raw = _m ? _m[1].toLowerCase() : '';
+                const _pfx = String(cmdPrefix || '').toLowerCase();
+                const _cmd = _raw && _pfx && _raw.startsWith(_pfx) ? '/' + _raw.slice(_pfx.length) : '';
+                const _isStaticTpl = ['/noi-quy', '/menu', '/huong-dan'].includes(_cmd)
+                    || (!!_cmd && !!resolveTemplateKeyByCommand(_cmd, pluginCfg));
+                if (!_isStaticTpl) return { handled: true };
+            }
 
             // ── MUTE CHECK — first gate, before everything else ───
             const isMuted = store.getSetting(groupId, 'muted', false);
@@ -6836,9 +6986,21 @@ Quy tắc:
             // ── Z2: Passive capture (zero-token) — TRƯỚC mention gating ──
             // Mọi tin group được phép vào ConversationBuffer + SQLite; khi bot
             // được tag sẽ inject bounded context. Tuyệt đối không gọi LLM ở đây.
-            zEngine.captureInbound({
+            // Duong bridge `onInbound` DA ghi MOI tin vao (msgId THAT + text THO). Den day
+            // `before_dispatch` khong con msgId nen engine phai bia `derived:<sender>:<ts>`, va
+            // `content` luc nay la ban DA BOC ("[userId: …, name: …]: …" + khoi "Recent group
+            // chat") ⇒ moi tin bi ghi HAI lan, Khung chat hien hai dong, dong thu hai lo ca prompt
+            // noi bo. Do that 30/08/2026: moi tin that deu co mot ban sinh doi id `derived:…`.
+            // Vi vay chi ghi khi KHONG co bridge (ban cai cu), con lai de bridge lam.
+            if (!globalThis.__zaloConnectBridgeService) zEngine.captureInbound({
                 accountId: ctx?.accountId,
-                conversationId: rawConvId,
+                // PHAI chuan hoa ve dang `group:<id>` — dung dang ma duong sync dung
+                // (zalo-mod-engine.js đã ghi chú đúng lỗi này cho đường của nó). Hook
+                // `before_dispatch` giao rawConvId dạng "'zalo-connect':<id>"; ghi thẳng chuỗi đó
+                // là CÙNG một nhóm nằm ở hai hàng hội thoại khác nhau, Khung chat hiện thành hai
+                // dòng với hai số đếm rời rạc — trên bot "Em Mơ" 30/08/2026 ra tận BA khoá:
+                // `group:1388…` 53 tin, `'zalo-connect':1388…` 7 tin, `1388…` 4 tin.
+                conversationId: groupId ? `group:${groupId}` : rawConvId,
                 groupId,
                 messageId: event?.msgId ?? event?.messageId ?? event?.cliMsgId,
                 senderId,

package/openclaw.plugin.json

@@ -3,7 +3,7 @@
   "name": "OpenClaw Zalo Mod",
   "description": "Zero-token Zalo group moderation — slash commands, anti-spam, warn system, memory integration. Blocks LLM for non-mention messages.",
   "icon": "https://cdn.simpleicons.org/zalo",
-  "version": "2.30.0",
+  "version": "2.31.1",
   "enabledByDefault": false,
   "activation": {
     "onStartup": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-zalo-mod",
-  "version": "2.30.0",
+  "version": "2.31.1",
   "description": "Zero-token Zalo group moderation plugin for OpenClaw — slash commands, anti-spam, warn system, and memory integration.",
   "type": "module",
   "main": "index.js",

package/src/context/conversation-buffer.js

@@ -48,8 +48,11 @@ export class ConversationBuffer {
                 senderId: event.quote.senderId != null ? String(event.quote.senderId) : undefined,
                 text: event.quote.text,
             }) : undefined,
+            // `url` PHAI giu: no la thu duy nhat cho phep khung chat hien anh that thay vi
+            // mot dong chu "[Media attachment]". Ban dau chi giu kind/filename/mime/size nen
+            // link bi cat ngay tai day, truoc khi kip ghi xuong SQLite.
             attachments: Object.freeze((event.attachments || []).map(a => ({
-                kind: a.kind, filename: a.filename, mime: a.mime, size: a.size,
+                kind: a.kind, filename: a.filename, mime: a.mime, size: a.size, url: a.url,
             }))),
             reactions: event.reactions ? Object.freeze([...event.reactions]) : undefined,
         });
@@ -86,6 +89,7 @@ export class ConversationBuffer {
                 rawType: rec.rawType,
                 sentAt: rec.timestamp,
                 quoteId: rec.quote?.messageId ?? null,
+                mediaUrls: (rec.attachments || []).map(a => a.url).filter(Boolean),
             });
         } catch {
             // Persistence là best-effort; buffer trong RAM vẫn là nguồn cho context.

package/src/integration/zalo-mod-engine.js

@@ -185,7 +185,7 @@ export function createZaloModEngine({ dataDir, logger, runtime, getConfig, confi
          * Ghi passive một tin group/DM được phép — gọi TRƯỚC mention gating.
          * Zero-token: chỉ RAM + SQLite. Không bao giờ throw (best-effort).
          */
-        captureInbound({ accountId, conversationId, groupId, messageId, senderId, senderName, text, timestamp, rawType, quote }) {
+        captureInbound({ accountId, conversationId, groupId, messageId, senderId, senderName, text, timestamp, rawType, quote, attachments }) {
             try {
                 const acc = accountId || 'default';
                 const ms = toMs(timestamp);
@@ -207,6 +207,10 @@ export function createZaloModEngine({ dataDir, logger, runtime, getConfig, confi
                     timestamp: ms,
                     rawType: rawType || 'message',
                     quote,
+                    // Thieu dong nay la anh/tep gui truc tiep bi mat link: khung chat chi con
+                    // chu "[Media attachment]" tron tro (tin keo ve bang Sync thi van co anh,
+                    // nen loi trong rat kho doan). Xem test media-capture.test.js.
+                    attachments,
                 });
             } catch (e) {
                 log.warn?.(`[zalo-mod] captureInbound bỏ qua: ${e.message}`);

package/src/storage/database.js

@@ -100,6 +100,21 @@ export class SqliteStore {
         return this._selRecent.all(conversationId, limit).reverse();
     }
 
+    /** Tin CHUA co media (media_json NULL) — dau vao cho viec ghep lai anh da tai ve. */
+    messagesWithoutMedia(limit = 5000) {
+        return this.db.prepare(`SELECT id, sent_at, from_self FROM messages
+            WHERE media_json IS NULL ORDER BY sent_at DESC LIMIT ?`).all(Math.min(Number(limit) || 5000, 20000));
+    }
+
+    /** Ga link media cho MOT tin da co. Tra ve true neu that su co dong bi sua. */
+    setMessageMedia(id, urls) {
+        const list = (Array.isArray(urls) ? urls : []).filter(Boolean);
+        if (!list.length) return false;
+        const r = this.db.prepare('UPDATE messages SET media_json = ? WHERE id = ? AND media_json IS NULL')
+            .run(JSON.stringify(list), String(id));
+        return Number(r.changes) > 0;
+    }
+
     /** Danh sách hội thoại, mới nhất trước — cột trái của khung chat. */
     listConversations({ accountId, limit = 100 } = {}) {
         const where = accountId ? 'WHERE account_id = ?' : '';

package/src/storage/media-backfill.js

@@ -0,0 +1,57 @@
+/**
+ * Ghép lại ảnh đã tải về với tin nhắn đã mất link.
+ *
+ * OpenClaw tải sẵn ảnh về `<home>/.openclaw/media/{inbound,outbound}` và đặt tên theo mốc thời gian
+ * (`2026-08-21T12-03-47-zalo-<hash>.jpg`). Trước bản vá P17, đường bắt tin trực tiếp đánh rơi link
+ * nên `media_json` là NULL — chữ "[Media attachment]" trơ ra dù ẢNH VẪN CÒN TRÊN ĐĨA.
+ *
+ * Hàm này nối hai thứ đó lại bằng thời gian.
+ *
+ * 🔴 Luật quan trọng: **chỉ nhận ghép 1-1**. Trong cửa sổ ±N giây mà có nhiều hơn một tệp thì BỎ QUA,
+ * không đoán. Gán nhầm ảnh của người này sang tin của người khác trong một khung chat CRM là hỏng
+ * nặng hơn nhiều so với việc thiếu một tấm ảnh.
+ */
+import { readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+const TEN_TEP = /^(\d{4}-\d{2}-\d{2})T(\d{2})-(\d{2})-(\d{2})/;
+const DUOI_HOP_LE = /\.(jpg|jpeg|png|gif|webp|mp4|pdf)$/i;
+
+/** Đọc kho media, trả về [{ url, t }] với `t` là mốc thời gian lấy từ TÊN TỆP. */
+export function docKhoMedia(openclawHome, kinds = ['inbound', 'outbound']) {
+    const out = [];
+    for (const kind of kinds) {
+        const dir = join(openclawHome, '.openclaw', 'media', kind);
+        if (!existsSync(dir)) continue;
+        for (const f of readdirSync(dir)) {
+            const m = TEN_TEP.exec(f);
+            if (!m || !DUOI_HOP_LE.test(f)) continue;
+            const t = Date.parse(`${m[1]}T${m[2]}:${m[3]}:${m[4]}Z`);
+            if (Number.isNaN(t)) continue;
+            out.push({ url: `/media/${kind}/${encodeURIComponent(f)}`, t, kind });
+        }
+    }
+    return out;
+}
+
+/**
+ * @returns {{ quet: number, ghep: number, boQuaNhapNhang: number, khongCo: number }}
+ */
+export function ghepLaiMedia(storage, openclawHome, { toleranceMs = 5000, limit = 5000, dryRun = false } = {}) {
+    const kho = docKhoMedia(openclawHome);
+    const tin = storage.messagesWithoutMedia?.(limit) || [];
+    let ghep = 0, boQuaNhapNhang = 0, khongCo = 0;
+
+    for (const t of tin) {
+        const sentAt = Number(t.sent_at) || 0;
+        // Tin của chính bot thì ảnh nằm ở `outbound`, tin người khác ở `inbound` — lọc theo đúng
+        // hướng để bớt hẳn nhập nhằng khi bot và khách gửi ảnh gần như cùng lúc.
+        const huong = t.from_self ? 'outbound' : 'inbound';
+        const ungVien = kho.filter((m) => m.kind === huong && Math.abs(m.t - sentAt) <= toleranceMs);
+        if (ungVien.length === 0) { khongCo++; continue; }
+        if (ungVien.length > 1) { boQuaNhapNhang++; continue; }
+        if (dryRun) { ghep++; continue; }
+        if (storage.setMessageMedia?.(t.id, [ungVien[0].url])) ghep++;
+    }
+    return { quet: tin.length, ghep, boQuaNhapNhang, khongCo };
+}