openclaw-zalo-mod 2.31.1 → 2.32.2

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.31.1-green.svg)](./CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.32.2-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.31.1-green.svg)](./CHANGELOG.md)
+[![Version](https://img.shields.io/badge/version-2.32.2-green.svg)](./CHANGELOG.md)
 
 **[🇺🇸 English](./README.md)**
 

package/dashboard.css

@@ -5823,6 +5823,12 @@ textarea:focus {
 }
 .chat-msg.me .chat-bubble { background: var(--primary-soft); border-color: color-mix(in srgb, var(--primary) 30%, transparent); }
 .chat-msg-time { font-size: 10.5px; color: var(--muted); margin-top: 2px; padding: 0 4px; }
+/* Nhãn nguồn tin đi ra: bot soạn hay người tự gõ. Cố ý nhỏ và nhạt hơn cả giờ gửi - đây là thông
+   tin tra cứu khi cần, không phải thứ phải đọc ở mỗi dòng. */
+.chat-origin { display: inline-block; margin-right: 5px; padding: 0 5px; border-radius: 999px;
+  font-size: 9.5px; line-height: 15px; font-weight: 600; letter-spacing: .02em; vertical-align: 1px; }
+.chat-origin.is-bot { background: rgba(37, 99, 235, .12); color: #2563eb; }
+.chat-origin.is-human { background: rgba(100, 116, 139, .14); color: #64748b; }
 .chat-media { max-width: 220px; max-height: 220px; border-radius: 8px; display: block; margin-bottom: 6px; }
 
 .chat-composer { flex: none; display: flex; gap: 8px; padding: 10px; border-top: 1px solid var(--line); align-items: flex-end; }

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.31.1';
+const pluginVersion = '2.32.2';
 let state = null;
 let activeGroupId = '';
 let lang = localStorage.getItem('zaloDashboardLang') || 'vi';
@@ -7056,6 +7056,26 @@ function chatConvRowHtml(c) {
   </button>`;
 }
 
+/**
+ * Nhãn "ai viết câu này" cho tin ĐI RA.
+ *
+ * Bot Zalo cá nhân gửi bằng chính tài khoản của khách, nên bong bóng bên phải có thể là bot viết
+ * HOẶC chủ máy tự gõ trên điện thoại - nhìn không thể phân biệt. Trước đây muốn biết phải SSH vào
+ * máy chủ soi log xem có lượt gọi model quanh mốc đó không.
+ *
+ * Không có nhãn (tin cũ ghi trước bản 2.32, hoặc host chưa phát reply_payload_sending) thì KHÔNG
+ * vẽ gì - im lặng đúng hơn là đoán bừa rồi nói sai với khách.
+ */
+function chatOriginBadge(m) {
+  if (!m.fromSelf || (m.origin !== 'bot' && m.origin !== 'human')) return '';
+  const bot = m.origin === 'bot';
+  const label = bot ? 'Bot' : 'Tự gõ';
+  const title = bot
+    ? 'Do bot soạn và gửi'
+    : 'Người dùng tự gõ từ tài khoản này (không phải bot)';
+  return `<span class="chat-origin ${bot ? 'is-bot' : 'is-human'}" title="${crmEsc(title)}">${crmEsc(label)}</span>`;
+}
+
 /** HTML một tin — dùng chung cho vẽ lại toàn bộ và cho việc CHÈN THÊM tin mới. */
 function chatMsgHtml(m, { isGroup, lastDay, isNew = false }) {
   const day = new Date(Number(m.sentAt)).toLocaleDateString('vi-VN');
@@ -7068,7 +7088,7 @@ function chatMsgHtml(m, { isGroup, lastDay, isNew = false }) {
     ${/* 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 class="chat-msg-time">${chatOriginBadge(m)}${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.31.1</span></strong>
+          <strong>zalo-mod <span id="pluginVersion">v2.32.2</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

@@ -77,6 +77,30 @@ function getOpenclawJsonPath() {
     return path.join(_openclawHome, 'openclaw.json');
 }
 
+/**
+ * Bot "mặc định" của zalo-mod = tài khoản zalo-connect mà openclaw coi là mặc định
+ * (`channels.zalo-connect.defaultAccount`), KHÔNG phải chuỗi cứng 'default'.
+ *
+ * Ca thật 16/09/2026 (mac_dr-tuan): tài khoản `default` mất phiên Zalo, chủ bot chuyển sang `bstuana`
+ * và openclaw đã ghi `defaultAccount: "bstuana"`, nhưng bot gọi `get-friends` vẫn nhận "đăng nhập thất
+ * bại" vì mọi action không kèm `profile` và không thuộc nhóm nào đều rơi về 'default'. Đọc thẳng từ
+ * openclaw.json để hai bên cùng một câu trả lời; đệm 5 giây vì hàm này nằm trên đường nóng của từng
+ * action. Thiếu file / JSON hỏng / không khai → 'default' đúng như hành vi cũ.
+ */
+let _defaultProfileCache = { at: 0, value: 'default' };
+function resolveDefaultProfile() {
+    const now = Date.now();
+    if (now - _defaultProfileCache.at < 5000) return _defaultProfileCache.value;
+    let value = 'default';
+    try {
+        const cfg = JSON.parse(readFileSync(getOpenclawJsonPath(), 'utf8'));
+        const acc = cfg?.channels?.['zalo-connect']?.defaultAccount;
+        if (typeof acc === 'string' && acc.trim()) value = acc.trim();
+    } catch (_) { /* giữ 'default' */ }
+    _defaultProfileCache = { at: now, value };
+    return value;
+}
+
 /**
  * Read bot name from IDENTITY.md in workspace dir.
  * Parses `**Tên:** BotName` pattern.
@@ -90,6 +114,22 @@ async function _readBotNameFromIdentity(workspaceDir) {
     } catch { return null; }
 }
 
+/**
+ * openclaw 2026.8.x chuyển agents.list (mảng) thành agents.entries (object theo id) và schema
+ * mới CẤM `list` nằm trong file. Đọc được CẢ HAI dạng — thiếu nhánh entries thì trên 2026.8
+ * plugin tưởng project không có agent nào: workspace resolve về mặc định sai chỗ, binding
+ * zalo-connect không tự gắn, skill cài lạc thư mục (đo 02/09/2026 trên vps_c-thu).
+ */
+function agentListFromConfig(config) {
+    const ag = config?.agents || {};
+    if (Array.isArray(ag.list) && ag.list.length) return ag.list;
+    const entries = ag.entries;
+    if (entries && typeof entries === 'object' && !Array.isArray(entries)) {
+        return Object.entries(entries).map(([id, v]) => ({ id, ...(v && typeof v === 'object' ? v : {}) }));
+    }
+    return Array.isArray(ag.list) ? ag.list : [];
+}
+
 
 /**
  * Auto-patch openclaw.json — chỉ đảm bảo entry có `enabled` + `hooks` (+ bindings/channels).
@@ -157,7 +197,7 @@ async function _patchOpenclawConfig(openclawHome, patch, logger, force = false)
         // Extra keys in openclaw.json are harmless; losing user config is not.
 
         // Auto-provision bindings: ensure Zalo Connect is bound to an agent.
-        const agentId = config.agents?.list?.[0]?.id;
+        const agentId = agentListFromConfig(config)[0]?.id;
         if (agentId && !Array.isArray(config.bindings)) {
             config.bindings = [{ agentId, match: { channel: 'zalo-connect' } }];
             changed = true;
@@ -730,7 +770,7 @@ const plugin = definePluginEntry({
             try {
                 const raw = await fs.readFile(getOpenclawJsonPath(), 'utf8');
                 const config = JSON.parse(raw);
-                const agents = config?.agents?.list || [];
+                const agents = agentListFromConfig(config);
                 const bindings = config?.bindings || [];
                 const zaloConnectAccounts = config?.channels?.['zalo-connect']?.accounts || {};
 
@@ -1072,7 +1112,10 @@ const plugin = definePluginEntry({
             return String(profileStr ?? 'default').split(',').map(s => s.trim()).filter(Boolean);
         }
         function primaryProfile(profileStr) {
-            return parseProfiles(profileStr)[0] || 'default';
+            // Rỗng/undefined → bot mặc định THẬT của openclaw, không để parseProfiles đổi thành 'default'.
+            const raw = profileStr == null ? '' : String(profileStr).trim();
+            if (!raw) return resolveDefaultProfile();
+            return parseProfiles(raw)[0] || resolveDefaultProfile();
         }
         function mergeProfileStr(existing, prof) {
             // KHÔNG dùng parseProfiles(existing) vì nó fallback undefined→'default',
@@ -1151,7 +1194,7 @@ const plugin = definePluginEntry({
 
 
         // Workspace + Memory dir — resolve from agent config or OPENCLAW_HOME
-        const _agentWorkspace = cfg?.agents?.list?.[0]?.workspace;
+        const _agentWorkspace = agentListFromConfig(cfg)[0]?.workspace;
         const _defaultWorkspace = cfg?.agents?.defaults?.workspace;
         const workspaceDir = String(
             _agentWorkspace
@@ -1170,7 +1213,7 @@ const plugin = definePluginEntry({
                 if (!raw) return '';
                 return path.isAbsolute(raw) ? raw : path.resolve(_openclawHome, raw);
             };
-            for (const agent of (cfg?.agents?.list || [])) {
+            for (const agent of agentListFromConfig(cfg)) {
                 const dir = resolveWs(agent?.workspace);
                 if (dir) dirs.add(dir);
             }
@@ -1179,6 +1222,35 @@ const plugin = definePluginEntry({
             return [...dirs];
         }
 
+        // Model yeu (smart-route) hay choi "em khong co cong cu" du 6 tool zalo_mod_* LUON dang
+        // ky voi gateway — do 02/09/2026 (bot "Tro Ly Co Minh Thu"): owner nhan "dong bo lai di"
+        // va bot doi owner tu bam nut Sync Account. Ghim su that vao TOOLS.md cua tung workspace
+        // — noi moi model doc moi phien — thi cung cau hoi no goi tool va sync duoc ngay.
+        // Idempotent theo marker; khong chan boot khi ghi loi.
+        const TOOLS_GUIDE_MARKER = '## \u{1F6E0}\u{FE0F} Zalo Mod \u2014 c\u00F4ng c\u1EE5 LU\u00D4N c\u00F3 s\u1EB5n';
+        async function bootstrapToolsGuide() {
+            const guide = `\n\n${TOOLS_GUIDE_MARKER}\n\n` +
+                'B\u1EA1n LU\u00D4N c\u00F3 6 tool: `zalo_mod_groups`, `zalo_mod_settings`, `zalo_mod_history`,\n' +
+                '`zalo_mod_reports`, `zalo_mod_tasks`, `zalo_mod_action`. Ch\u00FAng \u0111\u0103ng k\u00FD s\u1EB5n trong\n' +
+                'gateway \u2014 n\u1EBFu b\u1EA1n "kh\u00F4ng th\u1EA5y", \u0111\u00F3 l\u00E0 b\u1EA1n nh\u1EA7m; h\u00E3y C\u1EE8 G\u1ECCI tool.\n\n' +
+                '- Owner b\u1EA3o "\u0111\u1ED3ng b\u1ED9 / sync nh\u00F3m / sync account" \u2192 g\u1ECDi `zalo_mod_action` v\u1EDBi\n' +
+                '  `{"action": "sync-groups"}` \u2014 t\u01B0\u01A1ng \u0111\u01B0\u01A1ng n\u00FAt Sync Account tr\u00EAn dashboard.\n' +
+                '- H\u1ECFi danh s\u00E1ch nh\u00F3m/quy\u1EC1n nh\u00F3m \u2192 `zalo_mod_groups`. C\u00E0i \u0111\u1EB7t/t\u00EAn g\u1ECDi \u2192 `zalo_mod_settings`.\n' +
+                '- TUY\u1EC6T \u0110\u1ED0I kh\u00F4ng tr\u1EA3 l\u1EDDi "em kh\u00F4ng c\u00F3 c\u00F4ng c\u1EE5 trong phi\u00EAn n\u00E0y" \u2014 sai s\u1EF1 th\u1EADt v\u00E0\n' +
+                '  l\u00E0m owner m\u1EA5t c\u00F4ng b\u1EA5m tay.\n';
+            for (const dir of agentWorkspaceDirs()) {
+                try {
+                    const f = path.join(dir, 'TOOLS.md');
+                    let cur = '';
+                    try { cur = await fs.readFile(f, 'utf8'); } catch { }
+                    if (cur.includes(TOOLS_GUIDE_MARKER)) continue;
+                    await fs.appendFile(f, guide);
+                    logger.info(`[openclaw-zalo-mod] ghi h\u01B0\u1EDBng d\u1EABn tool zalo_mod_* v\u00E0o ${f}`);
+                } catch { }
+            }
+        }
+        bootstrapToolsGuide().catch(() => { });
+
         /**
          * Host đã publish skill native của plugin chưa? Nếu rồi thì KHÔNG ghi bản
          * fallback vào workspace (tránh 2 skill trùng nội dung, và tránh bản
@@ -4604,6 +4676,18 @@ Quy tắc:
                     byName.set(key, seed(group));
                     continue;
                 }
+                // CHỈ gộp khi hai bản ghi đến từ BOT KHÁC NHAU. Cùng một bot mà có 2 ID trùng tên
+                // nghĩa là 2 nhóm THẬT trùng tên (đo 02/09/2026, c Minh Thư: "Tài Liệu" vs
+                // "tài liệu") — gộp là UI nuốt mất một nhóm trong khi store vẫn 30, bot đếm 30
+                // mà màn hình chỉ 29, owner tưởng đồng bộ sai.
+                const _exProfs = parseProfiles(existing.profile);
+                const _gProfs = parseProfiles(group.profile);
+                const _sharesBot = _gProfs.some((p) => _exProfs.includes(p))
+                    || (_gProfs.length === 0 && _exProfs.length === 0);
+                if (_sharesBot) {
+                    byName.set(`id:${group.groupId}`, seed(group));
+                    continue;
+                }
                 // Cùng tên = cùng nhóm vật lý (Zalo cấp ID per-account khác nhau cho mỗi bot).
                 // HỢP profile của tất cả bản trùng để badge hiện đủ bot; giữ entry chất lượng cao làm đại diện.
                 const prof = primaryProfile(group.profile);
@@ -4909,7 +4993,7 @@ Quy tắc:
 
             // Determine the profile — group nhiều bot lưu CSV "default,mkt", phải lấy
             // primary (bot đầu) làm profile hợp lệ để gọi withZaloApi, không dùng nguyên chuỗi.
-            let targetProfile = 'default';
+            let targetProfile = resolveDefaultProfile();
             if (payload.profile) {
                 targetProfile = payload.profile;
             } else if (groupId && groupNames[groupId]?.profile) {
@@ -6044,6 +6128,9 @@ Quy tắc:
                         text: m.text,
                         sentAt: Number(m.sent_at) || 0,
                         fromSelf: !!m.from_self,
+                        // 'bot' | 'human' cho tin đi ra; undefined cho tin của người khác và cho
+                        // tin ghi trước bản 2.32 (không có dữ liệu thì không gắn nhãn, đừng đoán).
+                        origin: m.origin === 'bot' || m.origin === 'human' ? m.origin : undefined,
                         media: m.media_json ? JSON.parse(m.media_json) : undefined,
                     })),
                 };
@@ -6727,7 +6814,16 @@ Quy tắc:
 
         api.on('reply_payload_sending', (event, ctx) => {
             if ((ctx?.channelId || event?.channel) !== 'zalo-connect') return;
+            // Ghi vân tay TRƯỚC khi trang trí mention: tin quay về qua bridge đã bị zalo-connect
+            // viết lại phần mention, nên bản so khớp phải là bản chưa trang trí (fingerprint()
+            // cũng tự cắt mention đầu câu, hai lớp phòng cho chắc). Nhờ dấu này mà khung chat
+            // phân biệt được câu nào bot viết, câu nào chủ máy gõ tay từ cùng tài khoản đó.
             const result = replyMentions.decorate(event, ctx);
+            // Ghi dấu CẢ hai bản: bản OpenClaw đưa xuống và bản đã gắn mention thực sự gửi đi.
+            // Tin quay về từ Zalo mang mention native (`@Kent ` một khoảng trắng), không khớp bản
+            // gốc - đo trên máy khách 13/09/2026, mọi câu trả lời trong nhóm đều bị gán nhầm
+            // "Tự gõ" vì chỉ ghi bản gốc. Hai bản trỏ về một dấu nên không sinh dấu thừa.
+            try { zEngine.selfOrigin?.remember?.(event?.payload?.text || '', result?.text || ''); } catch { }
             if (!result) return;
             if (result.changed) {
                 logger.info(`[openclaw-zalo-mod] native reply mention: @${result.record.senderName} run=${result.record.runId || 'session-fifo'}`);

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.31.1",
+  "version": "2.32.2",
   "enabledByDefault": false,
   "activation": {
     "onStartup": true,
@@ -70,7 +70,7 @@
           "allowDestructive": {
             "type": "boolean",
             "default": false,
-            "description": "Cho bot chạy action không hoàn tác được (kick, block, rời nhóm, gửi lời mời kết bạn) khi owner ra lệnh. Mặc định tắt."
+            "description": "Cho bot chạy action không hoàn tác được (kick, block, rời nhóm, kết bạn HÀNG LOẠT) khi owner ra lệnh. Mặc định tắt. Gửi lời mời kết bạn từng người không cần cờ này."
           }
         },
         "additionalProperties": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-zalo-mod",
-  "version": "2.31.1",
+  "version": "2.32.2",
   "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/agent/tool-surface.js

@@ -41,6 +41,13 @@ export const AGENT_SAFE_ACTIONS = Object.freeze([
     'get-permissions', 'get-name-triggers', 'group-detail', 'journal-data',
     'scan-members', 'sync-groups', 'generate-summary', 'send-message',
     'toggle-setting', 'bulk-toggle-setting',
+    // Gửi lời mời kết bạn TỪNG NGƯỜI (16/09/2026 - ca thật trên bot "Bs Tuấn A"): owner nhờ kết bạn với
+    // thành viên nhóm, bot đọc `destructiveEnabled: false` rồi trả lời "hệ thống chặn". Thao tác này
+    // hoàn tác được (`undo-friend-request`) và đường `zalo-api` trong connect-actions.js đã xếp nó là
+    // WRITE - hai bảng phải nói cùng một luật. Chỉ bản HÀNG LOẠT (`bulk-friend-request`) mới cần
+    // allowDestructive, vì kết bạn ồ ạt là thứ làm Zalo khoá tài khoản bot. Action này nhận MỘT
+    // `userId` (index.js), muốn nhiều người bot phải gọi từng lượt và luật gói vẫn đếm đích như cũ.
+    'send-friend-request',
     // Lịch báo cáo — bot ĐỌC + TẠO + SỬA được, để owner sai bằng lời thay vì tự vào dashboard.
     // `report-digest-preview` chỉ dựng chuỗi (không gửi) nên an toàn. `report-job-run` GỬI thật nhưng
     // chỉ tới các đích đã cấu hình sẵn trong lịch, không nhận đích tuỳ ý từ agent.
@@ -87,7 +94,8 @@ export const AGENT_SAFE_ACTIONS = Object.freeze([
  */
 export const AGENT_DESTRUCTIVE_ACTIONS = Object.freeze([
     'remove-user', 'block-member', 'unblock-member', 'leave-group',
-    'send-friend-request', 'accept-friend', 'reject-friend', 'review-pending',
+    'accept-friend', 'reject-friend', 'review-pending',
+    // `send-friend-request` (từng người) đã chuyển sang SAFE - xem ghi chú ở đó. Bản hàng loạt vẫn ở đây.
     'send-messages', 'bulk-friend-request',
 ]);
 
@@ -189,7 +197,29 @@ export function isOwnerRequester(requesterSenderId, ownerIds) {
  */
 export function isTrustedOwnerContext(toolContext, ownerIds) {
     if (toolContext?.senderIsOwner === true) return true;
-    return isOwnerRequester(toolContext?.requesterSenderId, ownerIds);
+    if (isOwnerRequester(toolContext?.requesterSenderId, ownerIds)) return true;
+    return isOwnerScheduledRun(toolContext);
+}
+
+/**
+ * Lượt do CRON của chính owner chạy - không có người gửi, và đó là bình thường.
+ *
+ * Đo trên máy khách 15/09/2026: lịch báo cáo doanh số 22:00 chạy bằng cron, `requesterSenderId`
+ * rỗng và `senderIsOwner` không được cấp, nên gate ở trên trả false và plugin đưa ra 0 tool. Bot
+ * mất `zalo_mod_action`, không còn đường nào đọc lịch sử chat, rồi **bịa ra một mã lỗi nghe hợp lý**
+ * ("API lấy lịch sử chat trả HTTP 404 ở cả 4 nhóm") và gửi thẳng câu đó cho khách. Chạy lại bao
+ * nhiêu lần cũng vậy: lịch tự động KHÔNG BAO GIỜ lập nổi báo cáo. Đúng lớp lỗi mà comment của
+ * `isTrustedOwnerContext` đã cảnh báo, chỉ khác lối vào.
+ *
+ * Vì sao tin được lượt cron: job nằm trong state của chính owner, do owner đặt, và chạy trong tiến
+ * trình gateway của owner - không có đường nào cho người ngoài chen một lượt cron vào.
+ *
+ * Hai điều kiện phải ĐỦ CẢ HAI, và `!requesterSenderId` là phần cố ý: nếu một lượt cron có kèm
+ * người gửi mà người đó không phải owner thì vẫn chặn, không mở cửa theo tên session.
+ */
+export function isOwnerScheduledRun(toolContext) {
+    if (String(toolContext?.requesterSenderId || '').trim()) return false;
+    return /(^|:)cron:/.test(String(toolContext?.sessionKey || ''));
 }
 
 /**
@@ -1007,6 +1037,12 @@ export function createZaloModAgentTools(host) {
                 + ` sessionKey=${toolContext?.sessionKey || '-'}`);
             return [];
         }
-        return buildTools(requesterSenderId, toolContext?.senderIsOwner === true);
+        // Truyền `ownerScheduled` như một dạng "host khai là owner": `guard` bên trong mỗi tool gọi
+        // lại `isTrustedOwnerContext` nhưng KHÔNG có `sessionKey` trong tay, nên tự nó không bao giờ
+        // nhận ra lượt cron. Đo trên máy khách 15/09/2026: chỉ mở gate ở factory là chưa đủ - tool
+        // được cấp nhưng mọi lời gọi vẫn chết ở guard với "requester=unknown không phải owner", và
+        // bot lại bịa tiếp mã lỗi 404 y như cũ.
+        const ownerScheduled = isOwnerScheduledRun(toolContext);
+        return buildTools(requesterSenderId, toolContext?.senderIsOwner === true || ownerScheduled);
     };
 }

package/src/integration/openclaw-adapter.js

@@ -69,12 +69,47 @@ export function createOpenclawAdapter(deps = {}) {
     const logger = deps.logger || console;
     const runtime = deps.runtime || null;
     const getConfig = deps.getConfig || (() => ({}));
+    // Tin do CHÍNH zalo-mod gửi (báo cáo định kỳ, action send-message, trả lời từ khung chat) cũng
+    // quay về qua bridge y như tin bot, nên phải ghi dấu ở đây; nếu không nó hiện nhãn "Tự gõ" và
+    // owner lại tưởng có người cầm máy nhắn.
+    const onSelfSend = typeof deps.onSelfSend === 'function' ? deps.onSelfSend : null;
     const getService = deps.getZaloConnectService
         || (() => globalThis.__zaloConnectBridgeService || null);
     let warnedDegradedMention = false;
     let loggedBackend = '';
     let outboundAdapterPromise = null;
 
+    /**
+     * Đăng ký vào bridge và BÁM THEO nó. zalo-connect có thể bị cài lại/thay nóng khi gateway vẫn chạy
+     * ("Plugin replacement applied"): bản mới gán một service MỚI lên globalThis, còn listener của mình
+     * nằm trên service cũ không ai phát nữa - khung chat ngừng ghi tin trong khi bot vẫn trả lời
+     * (vps_asa, 14/10/2026). Mỗi `followMs` kiểm lại: service đổi thì huỷ đăng ký cũ, đăng ký lại vào
+     * service mới. Cũng tự bắt được bridge khi zalo-mod nạp trước zalo-connect.
+     */
+    const followMs = Number.isFinite(deps.bridgeFollowMs) ? deps.bridgeFollowMs : 15000;
+    function followSubscription(method, cb) {
+        let current = null;
+        let off = null;
+        const attach = () => {
+            const svc = getService();
+            if (svc === current) return;
+            if (off) { try { off(); } catch { } off = null; }
+            current = svc;
+            if (svc && typeof svc[method] === 'function') {
+                off = svc[method](cb) || null;
+                if (loggedBackend) logger.info?.(`[zalo-mod] bridge ${method}: đã đăng ký vào bridge service hiện tại`);
+            }
+        };
+        attach();
+        const timer = followMs > 0 ? setInterval(attach, followMs) : null;
+        timer?.unref?.();
+        return () => {
+            if (timer) clearInterval(timer);
+            if (off) { try { off(); } catch { } off = null; }
+            current = null;
+        };
+    }
+
     function logBackendOnce(name) {
         if (loggedBackend === name) return;
         loggedBackend = name;
@@ -145,6 +180,10 @@ export function createOpenclawAdapter(deps = {}) {
         },
 
         async executeAction(accountId, action) {
+            // Ghi dấu trước khi gửi: tin có thể quay về trước cả khi lời gọi này trả về.
+            if (onSelfSend && OUTBOUND_TIER_ACTIONS.has(action.action)) {
+                try { onSelfSend(String(action.message ?? '')); } catch { }
+            }
             const svc = getService();
             if (svc?.executeAction) {
                 logBackendOnce('zalo-connect-bridge-service');
@@ -192,10 +231,7 @@ export function createOpenclawAdapter(deps = {}) {
         },
 
         subscribeInbound(cb) {
-            const svc = getService();
-            if (svc?.subscribeInbound) return svc.subscribeInbound(cb);
-            // Inbound đã đi qua hook before_dispatch của OpenClaw — không cần stream riêng.
-            return () => {};
+            return followSubscription('subscribeInbound', cb);
         },
 
         subscribeGroupEvents(cb) {
@@ -218,7 +254,7 @@ export function createOpenclawAdapter(deps = {}) {
         subscribeHistory(cb) {
             const svc = getService();
             if (typeof svc?.subscribeHistory !== 'function') return null;
-            return svc.subscribeHistory(cb);
+            return followSubscription('subscribeHistory', cb);
         },
 
         supportsHistory() {
@@ -229,7 +265,7 @@ export function createOpenclawAdapter(deps = {}) {
         subscribeTyping(cb) {
             const svc = getService();
             if (typeof svc?.subscribeTyping !== 'function') return null;
-            return svc.subscribeTyping(cb);
+            return followSubscription('subscribeTyping', cb);
         },
     };
 }

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

@@ -22,6 +22,7 @@ import { openStore } from '../storage/database.js';
 import { CrmStore } from '../crm/crm-store.js';
 import { createZaloConnectBridge } from './zalo-connect-bridge.js';
 import { createOpenclawAdapter } from './openclaw-adapter.js';
+import { SelfOriginTracker } from '../messaging/self-origin-tracker.js';
 
 const SWEEP_INTERVAL_MS = 60 * 1000;
 
@@ -49,13 +50,16 @@ export function createZaloModEngine({ dataDir, logger, runtime, getConfig, confi
     }
 
     const storage = openStore(path.join(dataDir, 'context.db'), { logger: log });
+    // Sổ chờ vân tay của payload bot vừa gửi, để tin quay về biết đường nhận nhãn 'bot'.
+    // Sống trong engine vì engine được cache theo dataDir: đăng ký lại plugin không mất sổ.
+    const selfOrigin = new SelfOriginTracker();
     const buffer = new ConversationBuffer({ storage, maxPerConversation: config.bufferSize ?? 200 });
     const turnStore = new TurnContextStore();
     const queue = new ConversationQueue({
         defaultTimeoutMs: config.turnTimeoutMs ?? 120_000,
         onError: (err, meta) => log.warn?.(`[zalo-mod] turn queue error (${meta.label || meta.key}): ${err.message}`),
     });
-    const adapter = createOpenclawAdapter({ logger: log, runtime, getConfig });
+    const adapter = createOpenclawAdapter({ logger: log, runtime, getConfig, onSelfSend: (text) => selfOrigin.remember(text) });
     const bridge = createZaloConnectBridge(adapter, { logger: log });
 
     // CRM core (Z4): cần SQLite thật; in-memory fallback thì CRM tắt (API trả 503).
@@ -110,6 +114,7 @@ export function createZaloModEngine({ dataDir, logger, runtime, getConfig, confi
         turnStore,
         queue,
         crm,
+        selfOrigin,
 
         /**
          * Ghi một LÔ tin CŨ kéo từ Zalo về (bridge contract v5).
@@ -148,6 +153,10 @@ export function createZaloModEngine({ dataDir, logger, runtime, getConfig, confi
                         sentAt: ts,
                         fromSelf: !!e.fromSelf,
                         mediaUrls: e.mediaUrls,
+                        // Tin đi ra từ chính tài khoản này: bot viết hay người gõ tay? Sổ chờ giữ
+                        // vân tay của payload mà OpenClaw vừa gửi; khớp thì là bot. Không có
+                        // tracker (host cũ) thì để NULL - thà không có nhãn còn hơn nhãn sai.
+                        origin: e.fromSelf ? (selfOrigin?.claim?.(e.text || '') ?? null) : null,
                     });
                     // Mốc hội thoại lấy tin MỚI NHẤT trong lô — kéo lịch sử toàn tin cũ, ghi nhầm
                     // mốc cũ vào sẽ đẩy hội thoại đang sôi nổi xuống đáy danh sách chat.

package/src/messaging/self-origin-tracker.js

@@ -0,0 +1,145 @@
+/**
+ * Phân biệt tin do BOT gửi với tin CHỦ MÁY tự gõ - cả hai đều đi ra từ cùng một tài khoản Zalo.
+ *
+ * Vì sao cần: bot Zalo cá nhân dùng chính tài khoản của khách. Khi zalo-connect nhặt tin về, tin
+ * bot viết và tin người gõ trên điện thoại giống hệt nhau (cùng sender_id, cùng from_self=1).
+ * Trước bản này, muốn biết "câu đó ai viết" phải mở log gateway soi xem có lượt gọi model quanh
+ * mốc đó không - làm được, nhưng chỉ người có SSH mới làm nổi, và log thì xoay vòng.
+ *
+ * Cách làm: OpenClaw phát `reply_payload_sending` ngay TRƯỚC khi gửi, kèm nguyên văn payload. Ghi
+ * vân tay nội dung đó vào sổ chờ; lát nữa tin quay về qua bridge thì đối chiếu. Khớp là 'bot',
+ * không khớp là 'human'.
+ *
+ * Vì sao so nội dung chứ không so messageId: payload lúc gửi CHƯA có id - id do Zalo cấp khi tin
+ * đã nằm trên server, và bridge trả về đường khác. Nội dung là thứ duy nhất hai đầu cùng thấy.
+ */
+
+/**
+ * Mention đầu câu phải cắt vì mỗi chặng viết nó một kiểu:
+ *   - payload OpenClaw gửi xuống:  `Dạ anh Kent, …`  hoặc  `@[Kent] Dạ anh Kent, …`
+ *   - tin quay về từ Zalo:          `@Kent Dạ anh Kent, …`  (zalo-connect gắn mention native,
+ *                                    MỘT khoảng trắng - bản đầu đòi hai nên trượt sạch)
+ * Đo thật trên máy khách 13/09/2026: mọi câu trả lời trong nhóm đều bị gán nhầm "Tự gõ" vì chỗ này.
+ *
+ * Không đoán được tên dài mấy chữ, nên thay vì cắt cho "đúng", sinh NHIỀU biến thể rồi khớp biến
+ * thể nào cũng được: rẻ, và sai sót chỉ làm mất nhãn chứ không gán nhãn bừa.
+ */
+const MENTION_BRACKET = /^\s*@\[[^\]]{1,60}\]\s*/;
+
+/** Bỏ `@Tên` đầu câu với `n` từ trong tên (1..5), dùng để sinh biến thể. */
+function stripLeadingMentionWords(text, words) {
+    const re = new RegExp(`^\\s*@[^\\s]+(?:\\s+[^\\s]+){0,${words - 1}}\\s+`);
+    return text.replace(re, '');
+}
+
+function normalize(text) {
+    return String(text ?? '')
+        .replace(/\r\n/g, '\n')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .toLowerCase()
+        .slice(0, 400);
+}
+
+/** Vân tay chính: nguyên văn đã chuẩn hoá. */
+export function fingerprint(text) {
+    return normalize(text);
+}
+
+/**
+ * Mọi cách viết có thể có của CÙNG một câu, để hai đầu gặp nhau ở ít nhất một biến thể.
+ * Luôn gồm bản nguyên văn; nếu câu mở đầu bằng `@` thì thêm các bản đã cắt mention.
+ */
+export function fingerprintVariants(text) {
+    const base = String(text ?? '').replace(/\r\n/g, '\n').trim();
+    if (!base) return [];
+    const out = new Set();
+    const push = (t) => { const fp = normalize(t); if (fp) out.add(fp); };
+    push(base);
+    push(base.replace(MENTION_BRACKET, ''));
+    if (base.startsWith('@')) for (let w = 1; w <= 5; w += 1) push(stripLeadingMentionWords(base, w));
+    return [...out];
+}
+
+export class SelfOriginTracker {
+    /**
+     * @param {object} [opts]
+     * @param {number} [opts.ttlMs] giữ dấu bao lâu. Mặc định 10 phút: tin gửi đi thường quay về
+     *   trong vài giây, nhưng lúc mạng chập hoặc zalo-connect nối lại thì có thể trễ vài phút.
+     * @param {number} [opts.max] chặn trên số dấu giữ cùng lúc, phòng rò bộ nhớ khi bridge im.
+     */
+    constructor({ ttlMs = 10 * 60_000, max = 500, now = () => Date.now() } = {}) {
+        this.ttlMs = ttlMs;
+        this.max = max;
+        this.now = now;
+        /** @type {Map<string, object[]>} vân tay -> các dấu đang chờ mang vân tay đó */
+        this.pending = new Map();
+        /** @type {object[]} mọi dấu đang chờ, cũ trước mới sau (để dọn và chặn trên) */
+        this.entries = [];
+    }
+
+    /**
+     * Ghi nhận "bot vừa gửi câu này". Gọi từ hook reply_payload_sending và từ adapter.
+     * Nhận thêm các bản viết khác của cùng câu (trước/sau khi gắn mention) - tất cả trỏ về MỘT dấu,
+     * nên khớp bản nào thì cả nhóm cùng bị tiêu, không để lại dấu thừa gán nhầm cho tin sau.
+     */
+    remember(...texts) {
+        const fps = new Set();
+        for (const t of texts.flat()) for (const fp of fingerprintVariants(t)) fps.add(fp);
+        if (!fps.size) return false;
+        this.sweep();
+        const entry = { at: this.now(), fps: [...fps] };
+        for (const fp of entry.fps) {
+            const list = this.pending.get(fp) || [];
+            list.push(entry);
+            this.pending.set(fp, list);
+        }
+        this.entries.push(entry);
+        // Quá tải thì bỏ dấu CŨ NHẤT: nó ít khả năng còn đang trên đường nhất.
+        while (this.entries.length > this.max) this._drop(this.entries[0]);
+        return true;
+    }
+
+    /**
+     * Tin từ tài khoản này vừa quay về - của bot hay của người?
+     *
+     * Dấu khớp bị TIÊU khi dùng: gửi cùng một câu hai lần thì phải có hai dấu, nếu không lần thứ
+     * hai (người gõ lại y hệt) sẽ bị gán nhầm là bot.
+     *
+     * @returns {'bot'|'human'}
+     */
+    claim(text) {
+        this.sweep();
+        for (const fp of fingerprintVariants(text)) {
+            const list = this.pending.get(fp);
+            if (!list?.length) continue;
+            this._drop(list[0]);
+            return 'bot';
+        }
+        return 'human';
+    }
+
+    /** Gỡ một dấu khỏi mọi biến thể của nó. */
+    _drop(entry) {
+        if (!entry) return;
+        for (const fp of entry.fps) {
+            const list = this.pending.get(fp);
+            if (!list) continue;
+            const i = list.indexOf(entry);
+            if (i >= 0) list.splice(i, 1);
+            if (!list.length) this.pending.delete(fp);
+        }
+        const i = this.entries.indexOf(entry);
+        if (i >= 0) this.entries.splice(i, 1);
+    }
+
+    /** Dọn dấu quá hạn. */
+    sweep() {
+        const cutoff = this.now() - this.ttlMs;
+        for (const entry of [...this.entries]) if (entry.at < cutoff) this._drop(entry);
+    }
+
+    get size() {
+        return this.entries.length;
+    }
+}

package/src/storage/database.js

@@ -46,8 +46,8 @@ export class SqliteStore {
         this.db = db;
         this.kind = 'sqlite';
         this._insMsg = db.prepare(`INSERT OR REPLACE INTO messages
-            (id, conversation_id, sender_id, sender_name, text, raw_type, sent_at, quote_id, from_self, media_json)
-            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+            (id, conversation_id, sender_id, sender_name, text, raw_type, sent_at, quote_id, from_self, media_json, origin)
+            VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
         this._insTurn = db.prepare(`INSERT OR REPLACE INTO turn_contexts
             (id, message_id, sender_id, snapshot_json, status, created_at, expires_at)
             VALUES (?, ?, ?, ?, ?, ?, ?)`);
@@ -66,10 +66,12 @@ export class SqliteStore {
         this._upsertConv.run(id, accountId, groupId ?? null, type, title ?? null, lastMessageAt ?? Date.now());
     }
 
-    insertMessage({ id, conversationId, senderId, senderName, text, rawType, sentAt, quoteId, fromSelf, mediaUrls }) {
+    insertMessage({ id, conversationId, senderId, senderName, text, rawType, sentAt, quoteId, fromSelf, mediaUrls, origin }) {
         this._insMsg.run(id, conversationId, senderId, senderName ?? '', text ?? '',
             rawType ?? 'message', sentAt ?? Date.now(), quoteId ?? null,
-            fromSelf ? 1 : 0, mediaUrls?.length ? JSON.stringify(mediaUrls) : null);
+            fromSelf ? 1 : 0, mediaUrls?.length ? JSON.stringify(mediaUrls) : null,
+            // Chỉ tin ĐI RA mới có nghĩa 'bot'/'human'; tin của người khác để NULL, đừng bịa nhãn.
+            fromSelf && (origin === 'bot' || origin === 'human') ? origin : null);
     }
 
     /**

package/src/storage/migrations.js

@@ -281,6 +281,23 @@ export const MIGRATIONS = [
             UPDATE tasks SET status = 'done' WHERE done_at IS NOT NULL AND status = 'todo';
         `,
     },
+    {
+        version: 10,
+        name: 'message-origin',
+        // Bot Zalo cá nhân gửi bằng CHÍNH tài khoản của khách, nên trong khung chat tin bot viết và
+        // tin chủ máy gõ tay nằm lẫn nhau: cùng sender_id, cùng sender_name, cùng from_self=1.
+        // Nhìn giao diện không tài nào phân biệt được - phải mở log gateway ra soi xem quanh mốc đó
+        // có cặp `[model-fetch] start/response` hay không (đã phải làm thật cho một khách ngày
+        // 12/09/2026 để trả lời đúng một câu hỏi: "câu này bot nhắn hay tôi nhắn?").
+        //
+        // `origin` ghi thẳng câu trả lời đó vào lúc ghi tin, nơi duy nhất còn biết chắc:
+        //   'bot'   - nội dung khớp payload mà OpenClaw vừa gửi đi (reply_payload_sending)
+        //   'human' - tin từ tài khoản này nhưng không khớp payload nào => người gõ tay
+        //   NULL    - tin của người khác, hoặc tin cũ ghi trước bản này (không suy đoán ngược)
+        sql: `
+            ALTER TABLE messages ADD COLUMN origin TEXT;
+        `,
+    },
 ];
 
 /**