@invago/mixin 1.0.11 → 1.0.13

package/README.md

@@ -38,14 +38,22 @@ To install a specific version for the first time:
 openclaw plugins install @invago/mixin@<version>
 ```
 
-Then confirm the plugin is installed:
-
-```bash
-openclaw plugins list
-openclaw plugins info mixin
-```
-
-## Local Development Install
+Then confirm the plugin is installed:
+
+```bash
+openclaw plugins list
+openclaw plugins info mixin
+```
+
+## Cross-Platform Checklist
+
+- The same install commands work on Windows, Linux, and macOS.
+- Make sure `openclaw`, `node`, and your package manager (`npm` or `pnpm`) are available on `PATH`.
+- Voice duration detection needs `ffprobe`. If it is missing, audio falls back to file sending unless `audioRequireFfprobe` is enabled.
+- For local development, run `npm install` once and then `openclaw plugins install -l .` or `openclaw plugins install .`.
+- Runtime data is stored under the OpenClaw state directory resolved from `OPENCLAW_STATE_DIR`, `CLAWDBOT_STATE_DIR`, or `OPENCLAW_HOME`; no OS-specific path is required in plugin config.
+
+## Local Development Install
 
 If you are developing locally, clone the repository and install dependencies:
 
@@ -315,12 +323,14 @@ Mixin now supports formal group access controls in addition to direct-message `d
 - `groupPolicy: "disabled"` blocks the entire conversation.
 - `conversations.<conversationId>` overrides account-level group settings for that single conversation.
 
-Important delivery boundary:
-
-- In practice, Mixin group bots reliably receive messages when the bot is explicitly mentioned.
-- `requireMentionInGroup: false` only disables this plugin's own post-delivery filtering.
-- It does not guarantee that Mixin will deliver every non-mention group message to the bot.
-- If a non-mention group message produces no read receipt and no inbound log, the message most likely was not delivered to the plugin by Mixin in the first place.
+Important delivery boundary:
+
+- In practice, Mixin group bots reliably receive messages when the bot is explicitly mentioned.
+- The most reliable format is `@<identity_number> your message`, for example `@7000103034 hello`.
+- `requireMentionInGroup: false` only disables this plugin's own post-delivery filtering.
+- It does not guarantee that Mixin will deliver every non-mention group message to the bot.
+- If a non-mention group message produces no read receipt and no inbound log, the message most likely was not delivered to the plugin by Mixin in the first place.
+- Group quote/reply interactions are currently not treated as a reliable bot trigger, because Mixin may not deliver those events to the bot over Blaze consistently.
 
 Example:
 
@@ -373,10 +383,12 @@ Where to look in logs:
 - Unauthorized or filtered group logs include `group sender <user_id>` and `conversationId=<conversationId>`
 - If needed, temporarily enable a stricter group policy and let one member send a message once; the rejection log is often the fastest way to collect both values
 
-## Usage
-
-- Direct message: `/status` or `Hello`
-- Group message: `@Bot your question` with trigger words such as `?` or `help`
+## Usage
+
+- Direct message: `/status` or `Hello`
+- Group message: `@<identity_number> your question`
+- Recommended example: `@7000103034 help me summarize this`
+- Do not rely on quote-only or quote-plus-mention group replies as a stable trigger path.
 
 ## Operations
 

package/README.zh-CN.md

@@ -315,12 +315,14 @@ OpenClaw 支持通过 `bindings[].match.accountId` 把不同的频道账号直
 - `groupPolicy: "disabled"` 表示整个群会话被禁用。
 - `conversations.<conversationId>` 可以对某一个群会话覆盖账号级配置。
 
-关于群消息投递边界：
-
-- 目前从实际联调看，Mixin 群里稳定可用的触发方式仍然是显式 `@bot`。
-- `requireMentionInGroup: false` 只表示关闭插件自身的群消息二次过滤。
-- 它不能保证 Mixin 平台一定把所有未 `@` 的群消息投递给机器人。
-- 如果群里未 `@` 的消息既没有已读，也没有任何入站日志，通常说明这条消息根本没有被 Mixin 投递到插件。
+关于群消息投递边界：
+
+- 目前从实际联调看，Mixin 群里稳定可用的触发方式仍然是显式 `@bot`。
+- 最稳的写法是 `@<identity_number> + 文本`，例如 `@7000103034 你好`。
+- `requireMentionInGroup: false` 只表示关闭插件自身的群消息二次过滤。
+- 它不能保证 Mixin 平台一定把所有未 `@` 的群消息投递给机器人。
+- 如果群里未 `@` 的消息既没有已读，也没有任何入站日志，通常说明这条消息根本没有被 Mixin 投递到插件。
+- 目前群内“引用回复”不应被当成稳定触发方式，因为 Mixin 不一定会把这类事件稳定投递给 bot。
 
 示例：
 
@@ -376,10 +378,12 @@ OpenClaw 支持通过 `bindings[].match.accountId` 把不同的频道账号直
 - 群消息被拦截或未授权时，日志里会带 `group sender <user_id>` 和 `conversationId=<conversationId>`
 - 如果现场不好拿值，可以临时把群策略收紧一点，让目标成员先发一条消息；拒绝日志通常是最快同时拿到这两个值的方式
 
-## 使用方式
-
-- 私聊：`/status` 或 `Hello`
-- 群聊：`@Bot your question`，并带上 `?` 或 `help` 等触发词
+## 使用方式
+
+- 私聊：`/status` 或 `Hello`
+- 群聊：`@<identity_number> 你的问题`
+- 推荐示例：`@7000103034 帮我总结一下`
+- 目前不要把“仅引用回复”或“引用后再 @”当作稳定触发方式。
 
 ## 运维
 
@@ -696,3 +700,11 @@ Mixin 现在已经支持通过 MixPay one-time payment 做收款。
 - 本地开发建议使用 `openclaw plugins install -l .`。
 
 - 使用 `/setup` 进入配置引导流程。
+
+## 跨平台检查清单
+
+- Windows、Linux、macOS 都使用同一套安装命令。
+- 请确保 `openclaw`、`node` 和包管理器（`npm` 或 `pnpm`）已经加入 `PATH`。
+- 语音时长识别依赖 `ffprobe`。如果系统里没有它，音频会降级为按文件发送，除非你显式开启 `audioRequireFfprobe`。
+- 本地开发时，先执行一次 `npm install`，然后用 `openclaw plugins install -l .` 或 `openclaw plugins install .` 安装。
+- 运行时数据会存放在 OpenClaw 状态目录中，来源可能是 `OPENCLAW_STATE_DIR`、`CLAWDBOT_STATE_DIR` 或 `OPENCLAW_HOME`，插件配置里不需要写死操作系统路径。

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "mixin",
   "name": "Mixin Messenger Channel",
   "description": "Mixin Messenger channel via Blaze WebSocket",
-  "version": "1.0.10",
+  "version": "1.0.13",
   "channels": [
     "mixin"
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invago/mixin",
-  "version": "1.0.11",
+  "version": "1.0.13",
   "description": "Mixin Messenger channel plugin for OpenClaw",
   "type": "module",
   "main": "index.ts",
@@ -13,10 +13,13 @@
     "openclaw": ">=2026.2.0"
   },
   "dependencies": {
+    "@sinclair/typebox": "^0.34.48",
     "@mixin.dev/mixin-node-sdk": "^7.4.1",
     "@noble/curves": "^2.0.1",
     "@noble/hashes": "^2.0.1",
     "axios": "^1.13.6",
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1",
     "express": "^5.2.1",
     "jiti": "^1.21.0",
     "proxy-agent": "^6.5.0",

package/src/channel.ts

@@ -35,12 +35,43 @@ const conversationCategoryCache = new Map<string, {
   expiresAt: number;
 }>();
 
-function maskKey(key: string): string {
-  if (!key || key.length < 8) {
-    return "****";
-  }
-  return key.slice(0, 4) + "****" + key.slice(-4);
-}
+function maskKey(key: string): string {
+  if (!key || key.length < 8) {
+    return "****";
+  }
+  return key.slice(0, 4) + "****" + key.slice(-4);
+}
+
+function extractQuoteMessageId(rawMsg: unknown): string | undefined {
+  const seen = new Set<unknown>();
+  const stack: unknown[] = [rawMsg];
+
+  while (stack.length > 0) {
+    const value = stack.pop();
+    if (!value || typeof value !== "object" || seen.has(value)) {
+      continue;
+    }
+    seen.add(value);
+
+    const record = value as Record<string, unknown>;
+    const quoteMessageId = record.quote_message_id;
+    if (typeof quoteMessageId === "string" && quoteMessageId.trim()) {
+      return quoteMessageId.trim();
+    }
+    const camelQuoteMessageId = record.quoteMessageId;
+    if (typeof camelQuoteMessageId === "string" && camelQuoteMessageId.trim()) {
+      return camelQuoteMessageId.trim();
+    }
+
+    for (const nested of Object.values(record)) {
+      if (nested && typeof nested === "object") {
+        stack.push(nested);
+      }
+    }
+  }
+
+  return undefined;
+}
 
 async function resolveIsDirectMessage(params: {
   config: MixinAccountConfig;
@@ -429,18 +460,19 @@ export const mixinPlugin = {
                     `[mixin] inbound route context: messageId=${rawMsg.message_id}, conversationId=${rawMsg.conversation_id ?? ""}, userId=${rawMsg.user_id}, isDirect=${isDirect}`,
                   );
 
-                  const msg: MixinInboundMessage = {
-                    conversationId: rawMsg.conversation_id ?? "",
-                    userId: rawMsg.user_id,
-                    messageId: rawMsg.message_id,
-                    category: rawMsg.category ?? "PLAIN_TEXT",
-                    data: rawMsg.data_base64 ?? rawMsg.data ?? "",
-                    createdAt: rawMsg.created_at ?? new Date().toISOString(),
-                  };
-
-                  try {
-                    await handleMixinMessage({ cfg, accountId, msg, isDirect, log });
-                  } catch (err) {
+                  const msg: MixinInboundMessage = {
+                    conversationId: rawMsg.conversation_id ?? "",
+                    userId: rawMsg.user_id,
+                    messageId: rawMsg.message_id,
+                    category: rawMsg.category ?? "PLAIN_TEXT",
+                    data: rawMsg.data_base64 ?? rawMsg.data ?? "",
+                    createdAt: rawMsg.created_at ?? new Date().toISOString(),
+                    quoteMessageId: extractQuoteMessageId(rawMsg),
+                  };
+
+                  try {
+                    await handleMixinMessage({ cfg, accountId, msg, isDirect, log });
+                  } catch (err) {
                     log.error(`error handling message ${msg.messageId}`, err);
                   }
                 },

package/src/config-schema.ts

@@ -1,6 +1,18 @@
-import { DmPolicySchema, GroupPolicySchema } from "openclaw/plugin-sdk";
 import { z } from "zod";
 
+const DmPolicySchema = z.enum([
+  "pairing",
+  "allowlist",
+  "open",
+  "disabled",
+]);
+
+const GroupPolicySchema = z.enum([
+  "open",
+  "disabled",
+  "allowlist",
+]);
+
 export const MixinProxyConfigSchema = z.object({
   enabled: z.boolean().optional().default(false),
   url: z.string().optional(),

package/src/inbound-handler.ts

@@ -16,17 +16,19 @@ import {
   purgePermanentInvalidOutboxEntries,
   sendTextMessage,
 } from "./send-service.js";
-import { buildClient } from "./shared.js";
-
-export interface MixinInboundMessage {
-  conversationId: string;
-  userId: string;
-  messageId: string;
-  category: string;
-  data: string;
-  createdAt: string;
-  publicKey?: string;
-}
+import { buildClient } from "./shared.js";
+import { rememberMixinMessage, resolveMixinReplyContext } from "./message-context.js";
+
+export interface MixinInboundMessage {
+  conversationId: string;
+  userId: string;
+  messageId: string;
+  category: string;
+  data: string;
+  createdAt: string;
+  quoteMessageId?: string;
+  publicKey?: string;
+}
 
 const processedMessages = new Set<string>();
 const MAX_DEDUP_SIZE = 2000;
@@ -55,12 +57,19 @@ type CachedGroupProfile = {
   expiresAt: number;
 };
 
-type CachedBotProfile = {
-  name: string;
-  expiresAt: number;
-};
-
-type MixinAttachmentRequest = {
+type CachedBotProfile = {
+  name: string;
+  expiresAt: number;
+};
+
+type CachedBotIdentity = {
+  name: string;
+  userId: string;
+  identityNumber: string;
+  expiresAt: number;
+};
+
+type MixinAttachmentRequest = {
   attachmentId: string;
   mimeType?: string;
   size?: number;
@@ -68,10 +77,11 @@ type MixinAttachmentRequest = {
   duration?: number;
 };
 
-const cachedUserProfiles = new Map<string, CachedUserProfile>();
-const cachedGroupProfiles = new Map<string, CachedGroupProfile>();
-const cachedBotProfiles = new Map<string, CachedBotProfile>();
-let cachedUpdateSessionStore:
+const cachedUserProfiles = new Map<string, CachedUserProfile>();
+const cachedGroupProfiles = new Map<string, CachedGroupProfile>();
+const cachedBotProfiles = new Map<string, CachedBotProfile>();
+const cachedBotIdentities = new Map<string, CachedBotIdentity>();
+let cachedUpdateSessionStore:
   | ((storePath: string, mutator: (store: Record<string, Record<string, unknown>>) => void | Promise<void>) => Promise<unknown>)
   | null
   | undefined;
@@ -122,16 +132,20 @@ function pruneUnauthNotifiedGroups(now: number): void {
   }
 }
 
-function decodeContent(category: string, data: string): string {
-  if (category.startsWith("PLAIN_TEXT") || category.startsWith("PLAIN_POST")) {
+function decodeContent(category: string, data: string): string {
+  if (category.startsWith("PLAIN_TEXT") || category.startsWith("PLAIN_POST")) {
     try {
       return Buffer.from(data, "base64").toString("utf-8");
     } catch {
       return data;
     }
-  }
-  return `[${category}]`;
-}
+  }
+  return `[${category}]`;
+}
+
+function escapeRegExp(value: string): string {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
 
 function buildUserProfileCacheKey(accountId: string, userId: string): string {
   return `${accountId}:${userId.trim().toLowerCase()}`;
@@ -346,41 +360,51 @@ async function resolveGroupName(params: {
   }
 }
 
-async function resolveBotName(params: {
-  accountId: string;
-  config: MixinAccountConfig;
-  log: { info: (m: string) => void; warn: (m: string) => void; error: (m: string, e?: unknown) => void };
-}): Promise<string> {
-  const configuredName = normalizePresentationName(params.config.name ?? "");
-  if (configuredName) {
-    return configuredName;
-  }
-
-  const now = Date.now();
-  const cacheKey = buildBotProfileCacheKey(params.accountId);
-  const cached = cachedBotProfiles.get(cacheKey);
-  if (cached && cached.expiresAt > now) {
-    return cached.name;
-  }
-
-  pruneBotProfileCache(now);
-
-  try {
-    const client = buildClient(params.config);
-    const profile = await client.user.profile();
-    const name = normalizePresentationName(String(profile.full_name ?? "")) || params.accountId;
-    cachedBotProfiles.set(cacheKey, {
-      name,
-      expiresAt: now + BOT_PROFILE_CACHE_TTL_MS,
-    });
-    return name;
-  } catch (err) {
-    params.log.warn(
-      `[mixin] failed to resolve bot profile: accountId=${params.accountId}, error=${err instanceof Error ? err.message : String(err)}`,
-    );
-    return params.accountId;
-  }
-}
+async function resolveBotIdentity(params: {
+  accountId: string;
+  config: MixinAccountConfig;
+  log: { info: (m: string) => void; warn: (m: string) => void; error: (m: string, e?: unknown) => void };
+}): Promise<CachedBotIdentity> {
+  const cacheKey = buildBotProfileCacheKey(params.accountId);
+  const cached = cachedBotIdentities.get(cacheKey);
+  if (cached && cached.expiresAt > Date.now()) {
+    return cached;
+  }
+
+  const now = Date.now();
+  const configuredName = normalizePresentationName(params.config.name ?? "");
+  const configuredIdentity: CachedBotIdentity = {
+    name: configuredName || params.accountId,
+    userId: params.config.appId?.trim() || params.accountId,
+    identityNumber: "",
+    expiresAt: now + BOT_PROFILE_CACHE_TTL_MS,
+  };
+  if (configuredName) {
+    cachedBotIdentities.set(cacheKey, configuredIdentity);
+    return configuredIdentity;
+  }
+
+  pruneBotProfileCache(now);
+
+  try {
+    const client = buildClient(params.config);
+    const profile = await client.user.profile();
+    const identity: CachedBotIdentity = {
+      name: normalizePresentationName(String(profile.full_name ?? "")) || params.accountId,
+      userId: normalizePresentationName(String(profile.user_id ?? "")) || params.config.appId?.trim() || params.accountId,
+      identityNumber: normalizePresentationName(String(profile.identity_number ?? "")),
+      expiresAt: now + BOT_PROFILE_CACHE_TTL_MS,
+    };
+    cachedBotIdentities.set(cacheKey, identity);
+    return identity;
+  } catch (err) {
+    params.log.warn(
+      `[mixin] failed to resolve bot profile: accountId=${params.accountId}, error=${err instanceof Error ? err.message : String(err)}`,
+    );
+    cachedBotIdentities.set(cacheKey, configuredIdentity);
+    return configuredIdentity;
+  }
+}
 
 async function updateSessionPresentation(params: {
   storePath: string;
@@ -465,7 +489,7 @@ function parseInboundAttachmentRequest(category: string, data: string): MixinAtt
   }
 }
 
-function formatInboundAttachmentText(category: string, payload: MixinAttachmentRequest): string {
+function formatInboundAttachmentText(category: string, payload: MixinAttachmentRequest): string {
   if (category === "PLAIN_AUDIO") {
     const details = [
       payload.fileName,
@@ -481,10 +505,48 @@ function formatInboundAttachmentText(category: string, payload: MixinAttachmentR
     payload.mimeType,
     typeof payload.size === "number" ? `${payload.size} bytes` : undefined,
   ].filter(Boolean);
-  return details.length > 0 ? `[Mixin file] ${details.join(" | ")}` : "[Mixin file]";
-}
-
-async function resolveInboundAttachment(params: {
+  return details.length > 0 ? `[Mixin file] ${details.join(" | ")}` : "[Mixin file]";
+}
+
+function tryDecodeFallbackText(data: string): string | null {
+  if (!data) {
+    return null;
+  }
+
+  try {
+    const decoded = Buffer.from(data, "base64").toString("utf-8").replace(/^\uFEFF/, "").trim();
+    if (!decoded) {
+      return null;
+    }
+    const compact = decoded.replace(/\s+/g, "");
+    if (!compact) {
+      return null;
+    }
+    const printableCount = Array.from(compact).filter((char) => /[\p{L}\p{N}\p{P}\p{S}\u4e00-\u9fff]/u.test(char)).length;
+    if (printableCount / compact.length < 0.6) {
+      return null;
+    }
+    return decoded;
+  } catch {
+    return null;
+  }
+}
+
+function buildQuotedMessageContextNote(params: {
+  quoteMessageId: string;
+  found: boolean;
+}): string[] {
+  if (params.found) {
+    return [];
+  }
+
+  return [
+    `Quoted message id: ${params.quoteMessageId}`,
+    "Quoted message body was not available in cache.",
+  ];
+}
+
+async function resolveInboundAttachment(params: {
   rt: ReturnType<typeof getMixinRuntime>;
   config: MixinAccountConfig;
   msg: MixinInboundMessage;
@@ -533,13 +595,30 @@ async function resolveInboundAttachment(params: {
   }
 }
 
-function shouldPassGroupFilter(config: MixinAccountConfig, text: string): boolean {
-  if (!config.requireMentionInGroup) {
-    return true;
-  }
-  if (text.trim().startsWith("/")) {
-    return true;
-  }
+function hasBotMention(text: string, botName?: string): boolean {
+  const normalizedBotName = normalizePresentationName(botName ?? "").replace(/^@+/, "");
+  if (!normalizedBotName) {
+    return false;
+  }
+
+  const mentionPattern = new RegExp(`@\\s*${escapeRegExp(normalizedBotName)}(?=$|[\\s:：,，.!?。；;、])`, "i");
+  return mentionPattern.test(text);
+}
+
+function shouldPassGroupFilter(
+  config: MixinAccountConfig,
+  text: string,
+  botAliases: string[] = [],
+): boolean {
+  if (!config.requireMentionInGroup) {
+    return true;
+  }
+  if (botAliases.some((alias) => hasBotMention(text, alias))) {
+    return true;
+  }
+  if (text.trim().startsWith("/")) {
+    return true;
+  }
   const lower = text.toLowerCase();
   return lower.includes("?") || /帮我|请|分析|总结|help/i.test(lower);
 }
@@ -865,43 +944,103 @@ export async function handleMixinMessage(params: {
     }
   }
 
-  const isTextMessage = msg.category.startsWith("PLAIN_TEXT") || msg.category.startsWith("PLAIN_POST");
-  const isAttachmentMessage = msg.category === "PLAIN_DATA" || msg.category === "PLAIN_AUDIO";
-
-  if (!isTextMessage && !isAttachmentMessage) {
-    log.info(`[mixin] skip non-text message: ${msg.category}`);
-    return;
-  }
-
-  let text = decodeContent(msg.category, msg.data).trim();
-  let mediaPayload: AgentMediaPayload | undefined;
-  if (isAttachmentMessage) {
-    const resolved = await resolveInboundAttachment({ rt, config, msg, log });
-    text = resolved.text.trim();
-    mediaPayload = resolved.mediaPayload;
-  }
-  log.info(`[mixin] decoded text: messageId=${msg.messageId}, category=${msg.category}, length=${text.length}`);
-
-  if (!text) {
-    return;
-  }
-
-  const conversationPolicy = isDirect
-    ? null
-    : resolveConversationPolicy(cfg, accountId, msg.conversationId);
-
-  if (
-    !isDirect &&
-    conversationPolicy &&
-    !(isAttachmentMessage && conversationPolicy.mediaBypassMention) &&
-    !shouldPassGroupFilter({
-      ...config,
-      requireMentionInGroup: conversationPolicy.requireMention,
-    }, text)
-  ) {
-    log.info(`[mixin] group message filtered: ${msg.messageId}`);
-    return;
-  }
+  let isTextMessage = msg.category.startsWith("PLAIN_TEXT") || msg.category.startsWith("PLAIN_POST");
+  const isAttachmentMessage = msg.category === "PLAIN_DATA" || msg.category === "PLAIN_AUDIO";
+
+  if (!isTextMessage && !isAttachmentMessage) {
+    const fallbackText = tryDecodeFallbackText(msg.data);
+    if (fallbackText) {
+      log.warn(
+        `[mixin] treating unexpected category as text: messageId=${msg.messageId}, category=${msg.category}, fallbackLength=${fallbackText.length}`,
+      );
+      msg.category = "PLAIN_TEXT";
+      msg.data = Buffer.from(fallbackText).toString("base64");
+      isTextMessage = true;
+    }
+  }
+
+  if (!isTextMessage && !isAttachmentMessage) {
+    log.info(
+      `[mixin] skip non-text message: messageId=${msg.messageId}, category=${msg.category}, quoteMessageId=${msg.quoteMessageId ?? "none"}`,
+    );
+    return;
+  }
+
+  const decodedBody = decodeContent(msg.category, msg.data);
+  let text = decodedBody.trim();
+  let mediaPayload: AgentMediaPayload | undefined;
+  if (isAttachmentMessage) {
+    const resolved = await resolveInboundAttachment({ rt, config, msg, log });
+    text = resolved.text.trim();
+    mediaPayload = resolved.mediaPayload;
+  }
+  log.info(`[mixin] decoded text: messageId=${msg.messageId}, category=${msg.category}, length=${text.length}`);
+
+  const botIdentity = await resolveBotIdentity({
+    accountId,
+    config,
+    log,
+  });
+  const replyContext = resolveMixinReplyContext({
+    accountId,
+    conversationId: msg.conversationId,
+    quoteMessageId: msg.quoteMessageId,
+  });
+  rememberMixinMessage({
+    accountId,
+    conversationId: msg.conversationId,
+    messageId: msg.messageId,
+    senderId: msg.userId,
+    body: text,
+    timestamp: msg.createdAt,
+    direction: "inbound",
+    quoteMessageId: msg.quoteMessageId,
+  });
+  if (replyContext?.found) {
+    log.info(
+      `[mixin] reply context resolved: messageId=${msg.messageId}, quoteMessageId=${replyContext.id}, sender=${replyContext.sender ?? "unknown"}`,
+    );
+  } else if (replyContext?.id) {
+    log.info(
+      `[mixin] reply context missing from cache: messageId=${msg.messageId}, quoteMessageId=${replyContext.id}`,
+    );
+  }
+
+  if (!text) {
+    return;
+  }
+
+  const conversationPolicy = isDirect
+    ? null
+    : resolveConversationPolicy(cfg, accountId, msg.conversationId);
+
+  const botAliases = [
+    botIdentity.identityNumber,
+    botIdentity.userId,
+  ].filter((value): value is string => Boolean(value && value.trim()));
+  const groupMentioned = !isDirect && botAliases.some((alias) => hasBotMention(text, alias));
+  if (!isDirect) {
+    log.info(
+      `[mixin] group trigger check: messageId=${msg.messageId}, botName=${botIdentity.name}, botUserId=${botIdentity.userId}, botIdentityNumber=${botIdentity.identityNumber || "none"}, replyContext=${replyContext?.id ?? "none"}, mentioned=${groupMentioned}`,
+    );
+  }
+
+  if (
+    !isDirect &&
+    conversationPolicy &&
+    !(isAttachmentMessage && conversationPolicy.mediaBypassMention) &&
+    !shouldPassGroupFilter(
+      {
+        ...config,
+        requireMentionInGroup: conversationPolicy.requireMention,
+      },
+      text,
+      botAliases,
+    )
+  ) {
+    log.info(`[mixin] group message filtered: ${msg.messageId}`);
+    return;
+  }
 
   const effectiveAllowFrom = await readEffectiveAllowFrom(rt, accountId, config.allowFrom, log);
   const normalizedUserId = normalizeAllowEntry(msg.userId);
@@ -1115,33 +1254,28 @@ export async function handleMixinMessage(params: {
       })
     : undefined;
 
-  const senderName = await resolveSenderName({
-    accountId,
-    config,
-    userId: msg.userId,
-    log,
-  });
-  const botName = await resolveBotName({
-    accountId,
-    config,
-    log,
-  });
-  const groupName = isDirect
-    ? ""
-    : await resolveGroupName({
+  const senderName = await resolveSenderName({
+    accountId,
+    config,
+    userId: msg.userId,
+    log,
+  });
+  const groupName = isDirect
+    ? ""
+    : await resolveGroupName({
       accountId,
       config,
       conversationId: msg.conversationId,
       log,
     });
-  const conversationLabel = isDirect
-    ? clampSessionLabel(`${botName}-${senderName || msg.userId}`)
-    : clampSessionLabel(`${botName}-${groupName || msg.conversationId}`);
-
-  const ctx = rt.channel.reply.finalizeInboundContext({
-    Body: text,
-    RawBody: text,
-    CommandBody: text,
+  const conversationLabel = isDirect
+    ? clampSessionLabel(`${botIdentity.name}-${senderName || msg.userId}`)
+    : clampSessionLabel(`${botIdentity.name}-${groupName || msg.conversationId}`);
+
+  const ctx = rt.channel.reply.finalizeInboundContext({
+    Body: text,
+    RawBody: text,
+    CommandBody: text,
     From: isDirect ? msg.userId : msg.conversationId,
     SenderId: msg.userId,
     SenderName: senderName,
@@ -1150,14 +1284,22 @@ export async function handleMixinMessage(params: {
     ChatType: isDirect ? "direct" : "group",
     ConversationLabel: conversationLabel,
     GroupSubject: isDirect ? undefined : groupName || msg.conversationId,
-    Provider: "mixin",
-    Surface: "mixin",
-    MessageSid: msg.messageId,
-    CommandAuthorized: commandAuthorized,
-    OriginatingChannel: "mixin",
-    OriginatingTo: isDirect ? msg.userId : msg.conversationId,
-    ...mediaPayload,
-  });
+    Provider: "mixin",
+    Surface: "mixin",
+    MessageSid: msg.messageId,
+    ReplyToId: replyContext?.id,
+    ReplyToBody: replyContext?.body,
+    ReplyToSender: replyContext?.sender,
+    ReplyToIsQuote: replyContext ? true : undefined,
+    UntrustedContext: replyContext?.id ? buildQuotedMessageContextNote({
+      quoteMessageId: replyContext.id,
+      found: replyContext.found,
+    }) : undefined,
+    CommandAuthorized: commandAuthorized,
+    OriginatingChannel: "mixin",
+    OriginatingTo: isDirect ? msg.userId : msg.conversationId,
+    ...mediaPayload,
+  });
 
   const storePath = rt.channel.session.resolveStorePath(cfg.session?.store, {
     agentId: route.agentId,

package/src/message-context.ts

@@ -0,0 +1,114 @@
+type MixinMessageDirection = "inbound" | "outbound";
+
+export type MixinMessageContext = {
+  accountId: string;
+  conversationId: string;
+  messageId: string;
+  senderId?: string;
+  senderName?: string;
+  body: string;
+  timestamp: string;
+  direction: MixinMessageDirection;
+  quoteMessageId?: string;
+};
+
+export type ResolvedMixinReplyContext = {
+  id: string;
+  body?: string;
+  sender?: string;
+  senderId?: string;
+  timestamp?: string;
+  direction?: MixinMessageDirection;
+  found: boolean;
+};
+
+const MAX_MESSAGE_CONTEXTS = 4000;
+const recentMessages = new Map<string, MixinMessageContext>();
+
+function normalizeKeyPart(value: string | null | undefined): string {
+  return value?.trim().toLowerCase() ?? "";
+}
+
+function buildMessageContextKey(params: {
+  accountId: string;
+  conversationId: string;
+  messageId: string;
+}): string {
+  return [
+    normalizeKeyPart(params.accountId),
+    normalizeKeyPart(params.conversationId),
+    normalizeKeyPart(params.messageId),
+  ].join(":");
+}
+
+function pruneRecentMessages(): void {
+  while (recentMessages.size > MAX_MESSAGE_CONTEXTS) {
+    const first = recentMessages.keys().next().value;
+    if (!first) {
+      break;
+    }
+    recentMessages.delete(first);
+  }
+}
+
+export function rememberMixinMessage(context: MixinMessageContext): void {
+  const accountId = context.accountId.trim();
+  const conversationId = context.conversationId.trim();
+  const messageId = context.messageId.trim();
+  if (!accountId || !conversationId || !messageId) {
+    return;
+  }
+
+  recentMessages.set(
+    buildMessageContextKey({ accountId, conversationId, messageId }),
+    {
+      accountId,
+      conversationId,
+      messageId,
+      senderId: context.senderId?.trim() || undefined,
+      senderName: context.senderName?.trim() || undefined,
+      body: context.body ?? "",
+      timestamp: context.timestamp,
+      direction: context.direction,
+      quoteMessageId: context.quoteMessageId?.trim() || undefined,
+    },
+  );
+
+  pruneRecentMessages();
+}
+
+export function resolveMixinReplyContext(params: {
+  accountId: string;
+  conversationId: string;
+  quoteMessageId?: string | null;
+}): ResolvedMixinReplyContext | null {
+  const quoteMessageId = params.quoteMessageId?.trim();
+  if (!quoteMessageId) {
+    return null;
+  }
+
+  const message = recentMessages.get(
+    buildMessageContextKey({
+      accountId: params.accountId,
+      conversationId: params.conversationId,
+      messageId: quoteMessageId,
+    }),
+  );
+
+  if (!message) {
+    return {
+      id: quoteMessageId,
+      found: false,
+    };
+  }
+
+  return {
+    id: message.messageId,
+    body: message.body || undefined,
+    sender: message.senderName || message.senderId,
+    senderId: message.senderId,
+    timestamp: message.timestamp,
+    direction: message.direction,
+    found: true,
+  };
+}

package/src/send-service.ts

@@ -4,6 +4,7 @@ import os from "os";
 import path from "path";
 import type { OpenClawConfig } from "openclaw/plugin-sdk";
 import { getAccountConfig } from "./config.js";
+import { rememberMixinMessage } from "./message-context.js";
 import { getMixinBlazeSender, getMixinRuntime } from "./runtime.js";
 import { buildClient, sleep, type SendLog } from "./shared.js";
 
@@ -623,7 +624,7 @@ export async function sendTextMessage(
   text: string,
   log?: SendLog,
 ): Promise<SendResult> {
-  return sendMixinMessage(cfg, accountId, conversationId, recipientId, "PLAIN_TEXT", text, log);
+  return sendMixinMessage(cfg, accountId, conversationId, recipientId, "PLAIN_TEXT", text, log, text);
 }
 
 export async function sendPostMessage(
@@ -634,7 +635,7 @@ export async function sendPostMessage(
   text: string,
   log?: SendLog,
 ): Promise<SendResult> {
-  return sendMixinMessage(cfg, accountId, conversationId, recipientId, "PLAIN_POST", text, log);
+  return sendMixinMessage(cfg, accountId, conversationId, recipientId, "PLAIN_POST", text, log, text);
 }
 
 export async function sendFileMessage(
@@ -654,7 +655,16 @@ export async function sendFileMessage(
     mimeType,
   } satisfies FileOutboxBody);
 
-  return sendMixinMessage(cfg, accountId, conversationId, recipientId, "PLAIN_DATA", body, log);
+  return sendMixinMessage(
+    cfg,
+    accountId,
+    conversationId,
+    recipientId,
+    "PLAIN_DATA",
+    body,
+    log,
+    `${fileName} (${mimeType})`,
+  );
 }
 
 export async function sendAudioMessage(
@@ -674,7 +684,16 @@ export async function sendAudioMessage(
     waveForm: audio.waveForm,
   } satisfies AudioOutboxBody);
 
-  return sendMixinMessage(cfg, accountId, conversationId, recipientId, "PLAIN_AUDIO", body, log);
+  return sendMixinMessage(
+    cfg,
+    accountId,
+    conversationId,
+    recipientId,
+    "PLAIN_AUDIO",
+    body,
+    log,
+    `${path.basename(audio.filePath)} (${mimeType}${audio.duration ? `, ${audio.duration}s` : ""})`,
+  );
 }
 
 export async function sendButtonGroupMessage(
@@ -718,6 +737,7 @@ async function sendMixinMessage(
   category: MixinSupportedMessageCategory,
   body: string,
   log?: SendLog,
+  contextBody?: string,
 ): Promise<SendResult> {
   updateRuntime(cfg, log);
   await startSendWorker(cfg, log);
@@ -742,6 +762,17 @@ async function sendMixinMessage(
   await persistEntries();
   wakeWorker();
 
+  rememberMixinMessage({
+    accountId,
+    conversationId,
+    messageId: entry.messageId,
+    senderId: accountId,
+    senderName: "Mixin bot",
+    body: contextBody ?? body,
+    timestamp: now,
+    direction: "outbound",
+  });
+
   state.log.info(
     `[mixin] outbox enqueued: jobId=${entry.jobId}, messageId=${entry.messageId}, category=${category}, accountId=${accountId}, conversation=${conversationId}`,
   );