gewe-openclaw 2026.3.23 → 2026.3.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gewe-openclaw",
-  "version": "2026.3.23",
+  "version": "2026.3.24",
   "type": "module",
   "description": "OpenClaw GeWe channel plugin",
   "license": "MIT",

package/src/inbound.ts

@@ -113,6 +113,25 @@ function resolveAppMsgPlaceholder(appType?: number): string {
   return typeof appType === "number" ? `<appmsg:${appType}>` : "<appmsg>";
 }
 
+function summarizeUnsupportedInboundMessage(message: GeweInboundMessage): string {
+  const preview = message.text.replace(/\s+/g, " ").trim().slice(0, 120);
+  const parts = [
+    `msgType=${message.msgType}`,
+    `from=${message.fromId}`,
+    `to=${message.toId}`,
+    `sender=${message.senderId}`,
+    `messageId=${message.messageId}`,
+    `newMessageId=${message.newMessageId}`,
+    preview ? `text=${JSON.stringify(preview)}` : undefined,
+  ];
+  return parts.filter(Boolean).join(" ");
+}
+
+function summarizeTextPreview(text: string): string | undefined {
+  const preview = text.replace(/\s+/g, " ").trim().slice(0, 160);
+  return preview ? JSON.stringify(preview) : undefined;
+}
+
 function resolveGewePairCodeCandidate(rawBody: string): string | null {
   const trimmed = rawBody.trim();
   if (!trimmed) return null;
@@ -342,7 +361,7 @@ function normalizeInboundEntry(params: {
   const { message, runtime } = params;
   const msgType = message.msgType;
   if (![1, 3, 34, 43, 49].includes(msgType)) {
-    runtime.log?.(`gewe: skip unsupported msgType ${msgType}`);
+    runtime.log?.(`gewe: skip unsupported ${summarizeUnsupportedInboundMessage(message)}`);
     return null;
   }
 
@@ -834,10 +853,33 @@ export async function handleGeweInboundBatch(params: {
     return;
   }
 
-  const mentionRegexes = core.channel.mentions.buildMentionRegexes(config as OpenClawConfig);
-  const wasAtTriggered = mentionRegexes.length
+  const route = core.channel.routing.resolveAgentRoute({
+    cfg: config as OpenClawConfig,
+    channel: CHANNEL_ID,
+    accountId: account.accountId,
+    peer: {
+      kind: isGroup ? "group" : "direct",
+      id: isGroup ? groupId ?? "" : senderId,
+    },
+  });
+  const mentionRegexes = core.channel.mentions.buildMentionRegexes(
+    config as OpenClawConfig,
+    route.agentId,
+  );
+  const nativeAtWxids = Array.from(
+    new Set(
+      entries
+        .flatMap((entry) => entry.message.atWxids ?? [])
+        .map((wxid) => wxid.trim())
+        .filter(Boolean),
+    ),
+  );
+  const nativeAtAll = entries.some((entry) => entry.message.atAll === true);
+  const nativeAtTriggered = nativeAtWxids.includes(lastMessage.botWxid.trim());
+  const regexAtTriggered = mentionRegexes.length
     ? core.channel.mentions.matchesMentionPatterns(rawBodyCandidate, mentionRegexes)
     : false;
+  const wasAtTriggered = nativeAtTriggered || regexAtTriggered;
   const latestQuote = entries.at(-1)?.quoteDetails;
   const wasQuoteTriggered = Boolean(
     latestQuote &&
@@ -862,23 +904,32 @@ export async function handleGeweInboundBatch(params: {
     commandAuthorized,
   });
   if (triggerGate.shouldSkip) {
+    const detail =
+      triggerMode === "at"
+        ? [
+            `agent=${route.agentId ?? "default"}`,
+            `wasAtTriggered=${String(wasAtTriggered)}`,
+            `nativeAtTriggered=${String(nativeAtTriggered)}`,
+            `nativeAtAll=${String(nativeAtAll)}`,
+            `regexAtTriggered=${String(regexAtTriggered)}`,
+            `wasQuoteTriggered=${String(wasQuoteTriggered)}`,
+            `mentionRegexes=${JSON.stringify(mentionRegexes.map((regex) => regex.source))}`,
+            `nativeAtWxids=${JSON.stringify(nativeAtWxids)}`,
+            summarizeTextPreview(rawBodyCandidate)
+              ? `rawBody=${summarizeTextPreview(rawBodyCandidate)}`
+              : undefined,
+          ]
+            .filter(Boolean)
+            .join(" ")
+        : undefined;
     runtime.log?.(
       isGroup
-        ? `gewe: drop group ${groupId} (trigger=${triggerMode})`
-        : `gewe: drop DM sender ${senderId} (trigger=${triggerMode})`,
+        ? `gewe: drop group ${groupId} (trigger=${triggerMode})${detail ? ` ${detail}` : ""}`
+        : `gewe: drop DM sender ${senderId} (trigger=${triggerMode})${detail ? ` ${detail}` : ""}`,
     );
     return;
   }
 
-  const route = core.channel.routing.resolveAgentRoute({
-    cfg: config as OpenClawConfig,
-    channel: CHANNEL_ID,
-    accountId: account.accountId,
-    peer: {
-      kind: isGroup ? "group" : "direct",
-      id: isGroup ? groupId ?? "" : senderId,
-    },
-  });
   const storePath = core.channel.session.resolveStorePath(config.session?.store, {
     agentId: route.agentId,
   });

package/src/monitor.ts

@@ -23,6 +23,7 @@ import type {
   GeweWebhookServerOptions,
   ResolvedGeweAccount,
 } from "./types.js";
+import { extractAtUserList } from "./xml.js";
 
 const DEFAULT_WEBHOOK_PORT = 4399;
 const DEFAULT_WEBHOOK_HOST = "0.0.0.0";
@@ -155,6 +156,8 @@ function payloadToInboundMessage(payload: GeweCallbackPayload): GeweInboundMessa
   const groupParsed = isGroupChat ? splitGroupContent(content) : { body: content };
   const senderId = (isGroupChat ? groupParsed.senderId : fromId) ?? fromId;
   const text = groupParsed.body?.trim() ?? "";
+  const atWxids = extractAtUserList(data.MsgSource);
+  const atAll = atWxids.includes("notify@all");
 
   return {
     messageId: String(msgId),
@@ -166,6 +169,8 @@ function payloadToInboundMessage(payload: GeweCallbackPayload): GeweInboundMessa
     senderId,
     senderName: resolveSenderName(data.PushContent),
     text,
+    atWxids: atWxids.length ? atWxids : undefined,
+    atAll,
     msgType,
     xml: text,
     timestamp,
@@ -178,7 +183,7 @@ export function createGeweWebhookServer(opts: GeweWebhookServerOptions): {
   start: () => Promise<void>;
   stop: () => void;
 } {
-  const { port, host, path, mediaPath, secret, onMessage, onError, abortSignal } = opts;
+  const { port, host, path, mediaPath, secret, onRawPayload, onMessage, onError, abortSignal } = opts;
 
   const server = createServer(async (req: IncomingMessage, res: ServerResponse) => {
     if (req.url === HEALTH_PATH) {
@@ -230,6 +235,7 @@ export function createGeweWebhookServer(opts: GeweWebhookServerOptions): {
         return;
       }
 
+      onRawPayload?.(bodyResult.raw);
       const payload = parseWebhookPayload(bodyResult.raw);
       if (!payload) {
         res.writeHead(400, { "Content-Type": "application/json" });
@@ -357,6 +363,7 @@ export async function monitorGeweProvider(
     path,
     mediaPath: shouldStartMedia ? mediaPath : undefined,
     secret,
+    onRawPayload: (raw) => runtime.log?.(`[${account.accountId}] GeWe webhook raw: ${raw}`),
     onMessage: async (message) => {
       const isSelf = message.fromId === message.botWxid || message.senderId === message.botWxid;
       if (isSelf) return;

package/src/types.ts

@@ -175,6 +175,7 @@ export type GeweCallbackPayload = {
     ToUserName?: { string?: string };
     MsgType?: number;
     Content?: { string?: string };
+    MsgSource?: string;
     CreateTime?: number;
     PushContent?: string;
   };
@@ -190,6 +191,8 @@ export type GeweInboundMessage = {
   senderId: string;
   senderName?: string;
   text: string;
+  atWxids?: string[];
+  atAll?: boolean;
   msgType: number;
   xml?: string;
   timestamp: number;
@@ -202,6 +205,7 @@ export type GeweWebhookServerOptions = {
   path: string;
   mediaPath?: string;
   secret?: string;
+  onRawPayload?: (raw: string) => void;
   onMessage: (message: GeweInboundMessage) => void | Promise<void>;
   onError?: (error: Error) => void;
   abortSignal?: AbortSignal;

package/src/xml.ts

@@ -120,6 +120,24 @@ export function extractXmlTag(xml: string, tag: string): string | undefined {
   return decodeEntities(raw);
 }
 
+export function extractAtUserList(xml?: string): string[] {
+  const atUserList = xml?.trim() ? extractXmlTag(xml, "atuserlist") : undefined;
+  if (!atUserList) return [];
+
+  const seen = new Set<string>();
+  const values = atUserList
+    .split(/[,\uFF0C;\s]+/)
+    .map((value) => value.trim())
+    .filter(Boolean)
+    .filter((value) => {
+      if (seen.has(value)) return false;
+      seen.add(value);
+      return true;
+    });
+
+  return values;
+}
+
 export function extractAppMsgType(xml: string): number | undefined {
   const match = /<appmsg[\s\S]*?<type>(\d+)<\/type>/i.exec(xml);
   if (!match?.[1]) return undefined;