@invago/mixin 1.0.16 → 1.0.18

package/README.md

@@ -10,11 +10,12 @@ Connect [Mixin Messenger](https://mixin.one/messenger) to [OpenClaw](https://ope
 
 MixinClaw is an OpenClaw channel plugin. It runs in the same process as the OpenClaw Gateway, receives inbound messages from Mixin Blaze WebSocket, and delivers outbound messages over the Mixin HTTP API.
 
-Important:
-
-- Install the plugin on the same machine where the OpenClaw Gateway runs.
-- OpenClaw config files use JSON5, so comments and trailing commas are allowed.
-- The proxy configured by this plugin only affects this plugin.
+Important:
+
+- Install the plugin on the same machine where the OpenClaw Gateway runs.
+- OpenClaw config files use JSON5, so comments and trailing commas are allowed.
+- The proxy configured by this plugin only affects this plugin.
+- Per confirmed Mixin platform behavior, user messages in group chats are delivered to the bot only when the bot is explicitly mentioned.
 
 ## Recommended Install
 
@@ -325,11 +326,11 @@ Mixin now supports formal group access controls in addition to direct-message `d
 
 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`.
+- Per confirmed Mixin platform behavior, group messages from users are delivered to the bot only when the bot is explicitly mentioned.
+- Use `@<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.
+- It does not cause Mixin to forward non-mention user messages in groups to the bot.
+- If a non-mention user message produces no read receipt and no inbound log, the message 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:

package/README.zh-CN.md

@@ -10,11 +10,12 @@
 
 MixinClaw 是一个 OpenClaw 频道插件。它运行在 OpenClaw Gateway 同一进程中，使用 Mixin Blaze WebSocket 接收入站消息，并通过 Mixin HTTP API 发送出站消息。
 
-重要说明：
-
-- 插件需要安装在 OpenClaw Gateway 所在的机器上。
-- OpenClaw 配置文件使用 JSON5，支持注释和尾逗号。
-- 这里配置的代理只作用于这个插件，不影响其他插件。
+重要说明：
+
+- 插件需要安装在 OpenClaw Gateway 所在的机器上。
+- OpenClaw 配置文件使用 JSON5，支持注释和尾逗号。
+- 这里配置的代理只作用于这个插件，不影响其他插件。
+- 根据 Mixin 官方确认，群内用户消息只有在显式 `@` 机器人的情况下才会投递给 bot。
 
 ## 推荐安装方式
 
@@ -317,12 +318,12 @@ OpenClaw 支持通过 `bindings[].match.accountId` 把不同的频道账号直
 
 关于群消息投递边界：
 
-- 目前从实际联调看，Mixin 群里稳定可用的触发方式仍然是显式 `@bot`。
-- 最稳的写法是 `@<identity_number> + 文本`，例如 `@7000103034 你好`。
+- 根据 Mixin 官方确认，群内用户消息只有在显式 `@bot` 时才会投递给机器人。
+- 推荐写法是 `@<identity_number> + 文本`，例如 `@7000103034 你好`。
 - `requireMentionInGroup: false` 只表示关闭插件自身的群消息二次过滤。
-- 它不能保证 Mixin 平台一定把所有未 `@` 的群消息投递给机器人。
-- 如果群里未 `@` 的消息既没有已读，也没有任何入站日志，通常说明这条消息根本没有被 Mixin 投递到插件。
-- 目前群内“引用回复”不应被当成稳定触发方式，因为 Mixin 不一定会把这类事件稳定投递给 bot。
+- 它不会让 Mixin 把未 `@` 的群内用户消息投递给 bot。
+- 如果一条未 `@` 的群内用户消息既没有已读，也没有任何入站日志，那不是插件过滤了它，而是 Mixin 根本没有把这条消息送到插件。
+- 目前群内“引用回复”也不应被当成稳定触发方式，因为 Mixin 不一定会把这类事件稳定投递给 bot。
 
 示例：
 

package/openclaw.plugin.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@invago/mixin",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "Mixin Messenger channel plugin for OpenClaw",
   "type": "module",
   "main": "index.ts",

package/src/channel.ts

@@ -10,7 +10,7 @@ import { buildClient, sleep } from "./shared.js";
 import { MixinConfigSchema } from "./config-schema.js";
 import { describeAccount, isConfigured, listAccountIds, resolveAccount, resolveDefaultAccountId, resolveMediaMaxMb } from "./config.js";
 import type { MixinAccountConfig } from "./config-schema.js";
-import { handleMixinMessage, type MixinInboundMessage } from "./inbound-handler.js";
+import { handleMixinMessage, handleMixinSystemConversation, type MixinInboundMessage } from "./inbound-handler.js";
 import { getMixpayStatusSnapshot, startMixpayWorker } from "./mixpay-worker.js";
 import { mixinOnboardingAdapter } from "./onboarding.js";
 import { buildMixinOutboundPlanFromReplyPayload, executeMixinOutboundPlan } from "./outbound-plan.js";
@@ -459,8 +459,50 @@ export const mixinPlugin = {
               onSenderReady: (sender) => {
                 setMixinBlazeSender(accountId, sender);
               },
-              handler: {
-                onMessage: async (rawMsg: any) => {
+              handler: {
+                onConversation: async (rawMsg: any) => {
+                  if (stopped) {
+                    return;
+                  }
+                  if (!rawMsg || !rawMsg.message_id) {
+                    return;
+                  }
+
+                  const isDirect = await resolveIsDirectMessage({
+                    config,
+                    conversationId: rawMsg.conversation_id,
+                    userId: rawMsg.user_id,
+                    log,
+                  });
+                  const quoteMessageId = extractQuoteMessageId(rawMsg);
+                  const rawCategory = typeof rawMsg.category === "string" ? rawMsg.category : "SYSTEM_CONVERSATION";
+                  const rawData = typeof rawMsg.data_base64 === "string"
+                    ? rawMsg.data_base64
+                    : typeof rawMsg.data === "string"
+                      ? rawMsg.data
+                      : "";
+
+                  log.info(
+                    `[mixin] blaze inbound: messageId=${rawMsg.message_id}, conversationId=${rawMsg.conversation_id ?? ""}, userId=${rawMsg.user_id ?? ""}, category=${rawCategory}, isDirect=${isDirect}, quoteMessageId=${quoteMessageId ?? "none"}, dataLength=${rawData.length}`,
+                  );
+
+                  const msg: MixinInboundMessage = {
+                    conversationId: rawMsg.conversation_id ?? "",
+                    userId: rawMsg.user_id ?? "",
+                    messageId: rawMsg.message_id,
+                    category: rawCategory,
+                    data: rawData,
+                    createdAt: rawMsg.created_at ?? new Date().toISOString(),
+                    quoteMessageId,
+                  };
+
+                  try {
+                    await handleMixinSystemConversation({ cfg, accountId, msg, log });
+                  } catch (err) {
+                    log.error(`error handling system conversation ${msg.messageId}`, err);
+                  }
+                },
+                onMessage: async (rawMsg: any) => {
                   if (stopped) {
                     return;
                   }
@@ -471,24 +513,34 @@ export const mixinPlugin = {
                     return;
                   }
 
-                  const isDirect = await resolveIsDirectMessage({
-                    config,
-                    conversationId: rawMsg.conversation_id,
-                    userId: rawMsg.user_id,
-                    log,
-                  });
-                  log.info(
-                    `[mixin] inbound route context: messageId=${rawMsg.message_id}, conversationId=${rawMsg.conversation_id ?? ""}, userId=${rawMsg.user_id}, isDirect=${isDirect}`,
-                  );
-
+                  const isDirect = await resolveIsDirectMessage({
+                    config,
+                    conversationId: rawMsg.conversation_id,
+                    userId: rawMsg.user_id,
+                    log,
+                  });
+                  const quoteMessageId = extractQuoteMessageId(rawMsg);
+                  const rawCategory = typeof rawMsg.category === "string" ? rawMsg.category : "PLAIN_TEXT";
+                  const rawData = typeof rawMsg.data_base64 === "string"
+                    ? rawMsg.data_base64
+                    : typeof rawMsg.data === "string"
+                      ? rawMsg.data
+                      : "";
+                  log.info(
+                    `[mixin] blaze inbound: messageId=${rawMsg.message_id}, conversationId=${rawMsg.conversation_id ?? ""}, userId=${rawMsg.user_id}, category=${rawCategory}, isDirect=${isDirect}, quoteMessageId=${quoteMessageId ?? "none"}, dataLength=${rawData.length}`,
+                  );
+                  log.info(
+                    `[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 ?? "",
+                    category: rawCategory,
+                    data: rawData,
                     createdAt: rawMsg.created_at ?? new Date().toISOString(),
-                    quoteMessageId: extractQuoteMessageId(rawMsg),
+                    quoteMessageId,
                   };
 
                   try {