gewe-openclaw 2026.3.23 → 2026.3.25

package/README.md

@@ -141,7 +141,12 @@ openclaw onboard
 - `plain`：普通回复
 - `quote_source`：首条回复自动引用当前入站消息
 - `at_sender`：首条文本回复自动 `@` 发送者
-- `quote_and_at`：首条文本回复同时引用并 `@`；非文本回复会自动退化为 `quote_source`
+
+兼容说明：
+
+- `quote_and_at` 已下线，不再建议继续配置
+- 历史配置里的 `quote_and_at` 仍会被兼容读取，但会自动降级为 `quote_source + 可见 @昵称前缀`
+- 这个兼容降级不是微信原生 `@`，只是为了避免旧配置直接失效
 
 群聊默认值会跟随 `autoQuoteReply`：
 
@@ -167,6 +172,7 @@ openclaw onboard
 - `requireMention: true/false` 仍然可用，会分别映射到群聊 `trigger.mode = "at"` / `"any_message"`
 - 新的 `trigger` / `reply` 配置优先级更高
 - `autoQuoteReply` 现在主要用于“未显式配置 `reply.mode` 时”的默认值回退
+- 历史 `reply.mode = "quote_and_at"` 会自动降级为 `quote_source + 可见 @昵称前缀`
 
 示例：
 
@@ -182,7 +188,7 @@ openclaw onboard
         },
         "project-room@chatroom": {
           "trigger": { "mode": "at_or_quote" },
-          "reply": { "mode": "quote_and_at" },
+          "reply": { "mode": "at_sender" },
           "skills": ["project-skill"]
         },
         "ops-room@chatroom": {
@@ -303,7 +309,7 @@ GeWe 的状态页现在会额外显示：
           "groups": {
             "ops-room@chatroom": {
               "trigger": { "mode": "at_or_quote" },
-              "reply": { "mode": "quote_and_at" }
+              "reply": { "mode": "quote_source" }
             }
           }
         }

package/package.json

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

package/src/config-schema.ts

@@ -7,8 +7,11 @@ import {
   ToolPolicySchema,
   requireOpenAllowFrom,
 } from "./openclaw-compat.js";
+import type { GeweGroupReplyModeInput } from "./types.js";
 import { z } from "zod";
 
+const GEWE_GROUP_REPLY_MODES = ["plain", "quote_source", "at_sender", "quote_and_at"] as const;
+
 const GeweGroupTriggerSchema = z
   .object({
     mode: z.enum(["at", "quote", "at_or_quote", "any_message"]).optional(),
@@ -23,7 +26,15 @@ const GeweDmTriggerSchema = z
 
 const GeweGroupReplySchema = z
   .object({
-    mode: z.enum(["plain", "quote_source", "at_sender", "quote_and_at"]).optional(),
+    mode: z
+      .custom<GeweGroupReplyModeInput>(
+        (value) => typeof value === "string" && GEWE_GROUP_REPLY_MODES.includes(value as GeweGroupReplyModeInput),
+        {
+          message:
+            "invalid GeWe group reply mode; supported values are plain, quote_source, at_sender (quote_and_at is accepted only for compatibility)",
+        },
+      )
+      .optional(),
   })
   .strict();
 

package/src/inbound.ts

@@ -37,9 +37,9 @@ import {
 import type {
   CoreConfig,
   GeweDmReplyMode,
-  GeweGroupReplyMode,
   GeweInboundMessage,
   ResolvedGeweAccount,
+  ResolvedGeweGroupReplyMode,
 } from "./types.js";
 import {
   extractAppMsgType,
@@ -68,7 +68,7 @@ type PreparedInbound = {
   groupName?: string;
   groupSystemPrompt?: string;
   groupSkillFilter?: string[];
-  replyMode: GeweGroupReplyMode | GeweDmReplyMode;
+  replyMode: ResolvedGeweGroupReplyMode | GeweDmReplyMode;
   route: ReturnType<ReturnType<typeof getGeweRuntime>["channel"]["routing"]["resolveAgentRoute"]>;
   storePath: string;
   toWxid: string;
@@ -113,6 +113,41 @@ function resolveAppMsgPlaceholder(appType?: number): string {
   return typeof appType === "number" ? `<appmsg:${appType}>` : "<appmsg>";
 }
 
+function isQuoteFromBot(params: {
+  quoteDetails?: GeweQuoteDetails;
+  isGroup: boolean;
+  botWxid: string;
+}): boolean {
+  const quoteDetails = params.quoteDetails;
+  if (!quoteDetails) return false;
+  if (!params.isGroup) return true;
+
+  const botWxid = params.botWxid.trim();
+  if (!botWxid) return false;
+  return [quoteDetails.fromUsr, quoteDetails.chatUsr].some(
+    (value) => value?.trim() === botWxid,
+  );
+}
+
+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 +377,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;
   }
 
@@ -611,6 +646,7 @@ async function dispatchGeweInbound(params: {
           mode: prepared.replyMode,
           isGroup: prepared.isGroup,
           senderId: prepared.senderId,
+          senderName: prepared.senderName,
           defaultReplyToId: prepared.messageSid,
           repliedRef,
         });
@@ -834,15 +870,39 @@ 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 &&
-      (!isGroup || latestQuote.fromUsr?.trim() === lastMessage.botWxid.trim()),
-  );
+  const wasQuoteTriggered = isQuoteFromBot({
+    quoteDetails: latestQuote,
+    isGroup,
+    botWxid: lastMessage.botWxid,
+  });
   const triggerMode = isGroup
     ? resolveGeweGroupTriggerMode({
         groupConfig: groupMatch?.groupConfig,
@@ -862,23 +922,43 @@ 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(" ")
+        : triggerMode === "quote"
+          ? [
+              `wasQuoteTriggered=${String(wasQuoteTriggered)}`,
+              latestQuote?.fromUsr ? `quoteFromUsr=${JSON.stringify(latestQuote.fromUsr)}` : undefined,
+              latestQuote?.chatUsr ? `quoteChatUsr=${JSON.stringify(latestQuote.chatUsr)}` : undefined,
+              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/policy.ts

@@ -15,8 +15,9 @@ import type {
   GeweDmReplyMode,
   GeweDmTriggerMode,
   GeweGroupConfig,
-  GeweGroupReplyMode,
+  GeweGroupReplyModeInput,
   GeweGroupTriggerMode,
+  ResolvedGeweGroupReplyMode,
 } from "./types.js";
 
 function normalizeAllowEntry(raw: string): string {
@@ -189,16 +190,24 @@ export function resolveGeweDmTriggerMode(params: {
   return params.dmConfig?.trigger?.mode ?? params.wildcardConfig?.trigger?.mode ?? "any_message";
 }
 
+function resolveConfiguredGroupReplyMode(
+  configuredMode: GeweGroupReplyModeInput | undefined,
+): ResolvedGeweGroupReplyMode | undefined {
+  if (configuredMode === "quote_and_at") {
+    return "quote_and_at_compat";
+  }
+  return configuredMode;
+}
+
 export function resolveGeweGroupReplyMode(params: {
   groupConfig?: GeweGroupConfig;
   wildcardConfig?: GeweGroupConfig;
   autoQuoteReply?: boolean;
-}): GeweGroupReplyMode {
-  return (
-    params.groupConfig?.reply?.mode ??
-    params.wildcardConfig?.reply?.mode ??
-    (params.autoQuoteReply === false ? "plain" : "quote_source")
+}): ResolvedGeweGroupReplyMode {
+  const configuredMode = resolveConfiguredGroupReplyMode(
+    params.groupConfig?.reply?.mode ?? params.wildcardConfig?.reply?.mode,
   );
+  return configuredMode ?? (params.autoQuoteReply === false ? "plain" : "quote_source");
 }
 
 export function resolveGeweDmReplyMode(params: {

package/src/reply-options.ts

@@ -1,13 +1,13 @@
 import type { ReplyPayload } from "./openclaw-compat.js";
 import type {
   GeweDmReplyMode,
-  GeweGroupReplyMode,
   ResolvedGeweAccount,
+  ResolvedGeweGroupReplyMode,
 } from "./types.js";
 
 const CHANNEL_DATA_KEY = "gewe-openclaw";
 
-type GeweReplyMode = GeweGroupReplyMode | GeweDmReplyMode;
+type GeweReplyMode = ResolvedGeweGroupReplyMode | GeweDmReplyMode;
 type RepliedRef = { value: boolean };
 
 function canAttachAt(payload: ReplyPayload): boolean {
@@ -64,6 +64,38 @@ function withAtSender(payload: ReplyPayload, senderId: string | undefined): Repl
   };
 }
 
+function withAtSenderPrefix(payload: ReplyPayload, senderName: string | undefined): ReplyPayload {
+  const trimmedSenderName = senderName?.trim();
+  const trimmedText = payload.text?.trim();
+  if (!trimmedSenderName || !trimmedText) {
+    return payload;
+  }
+
+  const mentionPrefix = `@${trimmedSenderName}`;
+  if (trimmedText === mentionPrefix || trimmedText.startsWith(`${mentionPrefix} `) || trimmedText.startsWith(`${mentionPrefix}\u2005`)) {
+    return payload;
+  }
+
+  return {
+    ...payload,
+    text: `${mentionPrefix}\u2005${trimmedText}`,
+  };
+}
+
+function withoutDefaultReplyToId(
+  payload: ReplyPayload,
+  defaultReplyToId: string | undefined,
+): ReplyPayload {
+  const explicitReplyToId = payload.replyToId?.trim();
+  const trimmedDefaultReplyToId = defaultReplyToId?.trim();
+  if (!explicitReplyToId || !trimmedDefaultReplyToId || explicitReplyToId !== trimmedDefaultReplyToId) {
+    return payload;
+  }
+
+  const { replyToId: _ignored, ...rest } = payload;
+  return rest;
+}
+
 export function resolveGeweReplyOptions(
   account: Pick<ResolvedGeweAccount, "config">,
   opts?: { skillFilter?: string[] },
@@ -83,25 +115,33 @@ export function applyGeweReplyModeToPayload(
     mode: GeweReplyMode;
     isGroup: boolean;
     senderId?: string;
+    senderName?: string;
     defaultReplyToId?: string;
     repliedRef?: RepliedRef;
   },
 ): ReplyPayload {
   let nextPayload = payload;
   const effectiveMode =
-    params.mode === "quote_and_at" && !canAttachAt(payload) ? "quote_source" : params.mode;
+    params.mode === "quote_and_at_compat" && !canAttachAt(payload) ? "quote_source" : params.mode;
 
-  if (effectiveMode === "quote_source" || effectiveMode === "quote_and_at") {
+  if (effectiveMode === "quote_source" || effectiveMode === "quote_and_at_compat") {
     nextPayload = withReplyToId(nextPayload, params.defaultReplyToId, params.repliedRef);
   } else if (nextPayload.replyToId?.trim() && params.repliedRef) {
     params.repliedRef.value = true;
   }
 
+  if (effectiveMode === "plain" || effectiveMode === "at_sender") {
+    nextPayload = withoutDefaultReplyToId(nextPayload, params.defaultReplyToId);
+  }
+
   if (
     params.isGroup &&
-    (effectiveMode === "at_sender" || effectiveMode === "quote_and_at")
+    (effectiveMode === "at_sender" || effectiveMode === "quote_and_at_compat")
   ) {
-    nextPayload = withAtSender(nextPayload, params.senderId);
+    nextPayload = withAtSenderPrefix(nextPayload, params.senderName);
+    if (effectiveMode === "at_sender") {
+      nextPayload = withAtSender(nextPayload, params.senderId);
+    }
   }
 
   return nextPayload;

package/src/types.ts

@@ -9,7 +9,10 @@ import type {
 
 export type GeweGroupTriggerMode = "at" | "quote" | "at_or_quote" | "any_message";
 export type GeweDmTriggerMode = "any_message" | "quote";
-export type GeweGroupReplyMode = "plain" | "quote_source" | "at_sender" | "quote_and_at";
+export type GeweGroupReplyMode = "plain" | "quote_source" | "at_sender";
+export type GeweDeprecatedGroupReplyMode = "quote_and_at";
+export type GeweGroupReplyModeInput = GeweGroupReplyMode | GeweDeprecatedGroupReplyMode;
+export type ResolvedGeweGroupReplyMode = GeweGroupReplyMode | "quote_and_at_compat";
 export type GeweDmReplyMode = "plain" | "quote_source";
 
 export type GeweGroupTriggerConfig = {
@@ -21,7 +24,7 @@ export type GeweDmTriggerConfig = {
 };
 
 export type GeweGroupReplyConfig = {
-  mode?: GeweGroupReplyMode;
+  mode?: GeweGroupReplyModeInput;
 };
 
 export type GeweDmReplyConfig = {
@@ -175,6 +178,7 @@ export type GeweCallbackPayload = {
     ToUserName?: { string?: string };
     MsgType?: number;
     Content?: { string?: string };
+    MsgSource?: string;
     CreateTime?: number;
     PushContent?: string;
   };
@@ -190,6 +194,8 @@ export type GeweInboundMessage = {
   senderId: string;
   senderName?: string;
   text: string;
+  atWxids?: string[];
+  atAll?: boolean;
   msgType: number;
   xml?: string;
   timestamp: number;
@@ -202,6 +208,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;