@jerryliang122/openclaw-qqbot 1.0.6 → 1.0.8

package/README.md

@@ -12,7 +12,7 @@
 
 [![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
 [![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
-[![Platform](https://img.shields.io/badge/OpenClaw-%3E%3D2026.9.2-orange)](https://github.com/jerryliang122/qqbot-openclaw)
+[![Platform](https://img.shields.io/badge/OpenClaw-%3E%3D2026.9.1-orange)](https://github.com/jerryliang122/qqbot-openclaw)
 [![Node.js](https://img.shields.io/badge/Node.js->=18-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![Fork](https://img.shields.io/badge/fork-enhanced-9cf)](https://github.com/jerryliang122/qqbot-openclaw)
@@ -23,7 +23,7 @@
 
 > This is an **independently maintained fork** with its own versioning (v1.x, decoupled from the upstream 2.x line). Upstream: [tencent-connect/openclaw-qqbot](https://github.com/tencent-connect/openclaw-qqbot).
 >
-> **Requirements**: OpenClaw `>= 2026.9.2` · Published to npm as [`@jerryliang122/openclaw-qqbot`](https://www.npmjs.com/package/@jerryliang122/openclaw-qqbot). See [CHANGELOG](CHANGELOG.md) for differences vs the old version and the upgrade guide.
+> **Requirements**: OpenClaw `>= 2026.9.1` · Published to npm as [`@jerryliang122/openclaw-qqbot`](https://www.npmjs.com/package/@jerryliang122/openclaw-qqbot). See [CHANGELOG](CHANGELOG.md) for differences vs the old version and the upgrade guide.
 
 Scan to join the QQ group chat
 
@@ -179,7 +179,7 @@ Measures end-to-end latency from QQ server push to plugin response, broken down
 
 > **You**: `/bot-version`
 >
-> **QQBot**: 🦞 Framework: OpenClaw 2026.9.2 / 🤖 Plugin: v1.0.0 / 🌟 GitHub repo
+> **QQBot**: 🦞 Framework: OpenClaw 2026.9.1 / 🤖 Plugin: v1.0.0 / 🌟 GitHub repo
 
 Shows framework version, plugin version, and a direct link to the official repository.
 
@@ -282,7 +282,7 @@ Answers "why does this group have no context" diagnostics: the push mode is chos
 
 ### Step 2 — Install / Upgrade the Plugin
 
-> **Note**: The unscoped npm name `openclaw-qqbot` belongs to the original upstream project — this fork publishes as the scoped package `@jerryliang122/openclaw-qqbot`. Requires OpenClaw >= 2026.9.2.
+> **Note**: The unscoped npm name `openclaw-qqbot` belongs to the original upstream project — this fork publishes as the scoped package `@jerryliang122/openclaw-qqbot`. Requires OpenClaw >= 2026.9.1.
 
 **Option A: Install from npm (Recommended)**
 

package/README.zh.md

@@ -10,14 +10,14 @@
 **让你的 AI 助手接入 QQ — 私聊、群聊、富媒体，一个插件全搞定。**
 
 > 本仓库为**独立维护的 fork**，自 v1.0.0 起独立发版（与上游 2.x 版本线完全脱钩）。
-> 运行要求：OpenClaw `>= 2026.9.2`；npm 包名 [`@jerryliang122/openclaw-qqbot`](https://www.npmjs.com/package/@jerryliang122/openclaw-qqbot)。
+> 运行要求：OpenClaw `>= 2026.9.1`；npm 包名 [`@jerryliang122/openclaw-qqbot`](https://www.npmjs.com/package/@jerryliang122/openclaw-qqbot)。
 > 与旧版本的差异及升级指南见 [CHANGELOG](CHANGELOG.md)。上游仓库：[tencent-connect/openclaw-qqbot](https://github.com/tencent-connect/openclaw-qqbot)。
 
 ### 🚀 当前版本： `v1.0.0`
 
 [![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
 [![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
-[![Platform](https://img.shields.io/badge/OpenClaw-%3E%3D2026.9.2-orange)](https://github.com/jerryliang122/qqbot-openclaw)
+[![Platform](https://img.shields.io/badge/OpenClaw-%3E%3D2026.9.1-orange)](https://github.com/jerryliang122/qqbot-openclaw)
 [![Node.js](https://img.shields.io/badge/Node.js->=18-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 
@@ -177,7 +177,7 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 > **你**：`/bot-version`
 >
-> **QQBot**：🦞框架版本：OpenClaw 2026.9.2 / 🤖QQBot 插件版本：v1.0.0 / 🌟GitHub 仓库
+> **QQBot**：🦞框架版本：OpenClaw 2026.9.1 / 🤖QQBot 插件版本：v1.0.0 / 🌟GitHub 仓库
 
 一目了然查看框架版本、插件版本，并可直接跳转官方仓库。
 
@@ -282,7 +282,7 @@ AI 可直接发送视频，支持本地文件和公网 URL。
 
 ### 第二步 — 安装 / 升级插件
 
-> 无 scope 的 npm 包名 `openclaw-qqbot` 属于上游原项目——本 fork 以 `@jerryliang122/openclaw-qqbot` 发布。要求 OpenClaw >= 2026.9.2。
+> 无 scope 的 npm 包名 `openclaw-qqbot` 属于上游原项目——本 fork 以 `@jerryliang122/openclaw-qqbot` 发布。要求 OpenClaw >= 2026.9.1。
 
 **方式 A：从 npm 安装（推荐）**
 

package/dist/index.cjs

@@ -8259,7 +8259,7 @@ var init_outbound_service = __esm({
 
 // src/utils/pkg-version.ts
 function getPackageVersion() {
-  return true ? "1.0.6" : "unknown";
+  return true ? "1.0.8" : "unknown";
 }
 function getOpenclawVersion(runtimeVersion) {
   return runtimeVersion && runtimeVersion !== "unknown" ? runtimeVersion : "unknown";
@@ -10454,7 +10454,7 @@ function getAdapters(rt, log5) {
 async function persistAuthConfig(runtime2, cfg, afterWrite = "restart") {
   const config = runtime2.config;
   if (typeof config?.mutateConfigFile !== "function") {
-    throw new Error("persistAuthConfig: runtime.config.mutateConfigFile is unavailable (requires openclaw >= 2026.9.2)");
+    throw new Error("persistAuthConfig: runtime.config.mutateConfigFile is unavailable (requires openclaw >= 2026.9.1)");
   }
   await config.mutateConfigFile({
     mutate: () => cfg,
@@ -14492,6 +14492,7 @@ function mapQuote(quote) {
   return {
     content: quote.text,
     senderId: quote.entry?.senderId ?? "",
+    messageId: quote.entry?.messageId,
     attachments: quote.attachments
   };
 }
@@ -14708,7 +14709,24 @@ function buildCtxPayload(params) {
     },
     reply: {
       to: envelope.targetId,
-      replyToId: envelope.messageId,
+      /**
+       * ReplyToId 契约语义 = 当前消息回复(引用)的那条消息的 ID —— 对齐
+       * telegram 原生通道（replyHead?.messageId ?? visibleReplyTarget?.id），
+       * 无引用时必须为 undefined。框架将其渲染为模型可见 Conversation info
+       * 的 reply_to_id 字段。
+       *
+       * 历史版本误填 envelope.messageId（消息自身 ID），导致每条消息都呈现
+       * message_id == reply_to_id —— 被上层 agent 的 AGENTS 规则判为「内部
+       * 回灌、非新指令」而拒绝响应（2026-09-22 事故）。
+       *
+       * QQ 被动回复锚点不依赖此字段：deliverCtx.replyToId / msgid-cache 兜底
+       * （resolvePassiveFirstReplyToId）/ attachMsgIdWithQuota 均独立取值，
+       * threading resolveReplyToMode='off' 阻断框架隐式回复线程。
+       *
+       * 防御守卫：即使上游异常传入当前消息 ID（自引用），也强制置空——
+       * 「reply_to_id == message_id」这一假回灌签名在任何路径都不允许再现。
+       */
+      replyToId: envelope.quote?.messageId && envelope.quote.messageId !== envelope.messageId ? envelope.quote.messageId : void 0,
       originatingTo: envelope.targetId
     },
     access: {
@@ -14717,7 +14735,14 @@ function buildCtxPayload(params) {
     command: isSlashCommand ? { kind: "text-slash", body: assembled.rawBody, authorized: true } : void 0,
     media: mediaFacts.length > 0 ? mediaFacts : void 0,
     supplemental: {
-      quote: envelope.quote ? { id: envelope.messageId, body: envelope.quote.content, sender: envelope.quote.senderId } : void 0,
+      // quote.id 同样必须是「被引用消息」的真实 ID（ref-index 命中时），
+      // 而非当前消息 ID——框架经 applySupplementalContext 映射为
+      // ctx.ReplyToId / "Reply target of current user message"。
+      quote: envelope.quote ? {
+        ...envelope.quote.messageId && envelope.quote.messageId !== envelope.messageId ? { id: envelope.quote.messageId } : {},
+        body: envelope.quote.content,
+        sender: envelope.quote.senderId
+      } : void 0,
       groupSystemPrompt: envelope.systemPrompt
     },
     extra: {
@@ -15106,7 +15131,7 @@ async function dispatchToOpenClaw(ctx, msg, account, runtime2, log5) {
   const envelope = buildEnvelope2(ctx, msg, account);
   dlog?.debug(`received sender=${envelope.senderId} scope=${envelope.chatScope} msgId=${envelope.messageId}`);
   if (!adapters.inboundRun || !adapters.dispatchReply) {
-    dlog?.error(`runtime adapter inboundRun/dispatchReply not available (openclaw=${adapters.version}, requires >=2026.9.2)`);
+    dlog?.error(`runtime adapter inboundRun/dispatchReply not available (openclaw=${adapters.version}, requires >=2026.9.1)`);
     return;
   }
   const assembled = ctx.state.assembledBody ?? assembleBody(ctx, msg, account);