@jerryliang122/openclaw-qqbot 1.0.6 → 1.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jerryliang122/openclaw-qqbot",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "QQ Bot channel plugin for OpenClaw (independently maintained fork)",
   "publishConfig": {
     "access": "public",
@@ -48,14 +48,14 @@
   },
   "devDependencies": {
     "@types/node": "^20.19.43",
-    "openclaw": "2026.9.2",
+    "openclaw": "2026.9.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "tsx": "^4.23.13"
   },
   "peerDependencies": {
     "@tencent-connect/qqbot-connector": "1.2.0",
-    "openclaw": ">=2026.9.2"
+    "openclaw": ">=2026.9.1"
   },
   "homepage": "https://github.com/jerryliang122/qqbot-openclaw",
   "repository": {

package/src/adapter/pairing.ts

@@ -3,7 +3,7 @@
  *
  * readAllowFromStore / issueChallenge / buildReply 直接来自稳定 subpath。
  *
- * approveCode 例外：`approveChannelPairingCode` 在 2026.9.2 未从任何
+ * approveCode 例外：`approveChannelPairingCode` 在 2026.9.1/2026.9.2 均未从任何
  * plugin-sdk subpath 导出（只存在于内部 pairing-store chunk 与
  * `openclaw pairing approve` CLI），走与网关同源的 CLI 执行
  * （见 secret-store-cli 的 resolveOpenClawCli 同源约束）。

package/src/adapter/resolve.ts

@@ -2,7 +2,7 @@
  * Runtime Adapters — 一次 resolve，全程复用。
  *
  * Capability Probe 模式：按候选 API 路径探测，选出第一个可用函数。
- * 构建基线为 openclaw 2026.9.2（peer >=2026.9.2），不再保留对更旧版本的回退。
+ * 构建基线为 openclaw 2026.9.1（peer >=2026.9.1），不再保留对更旧版本的回退。
  *
  * 调用方通过 `resolveRuntimeAdapters(runtime)` 获取适配层对象，
  * 后续所有 dispatch / channel 代码只使用 adapters 上的方法。
@@ -237,7 +237,7 @@ export async function persistAuthConfig(
   const config: Record<string, unknown> | undefined = runtime.config as any;
 
   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 as Function)({
     mutate: () => cfg,

package/src/adapter/setup.ts

@@ -1,7 +1,7 @@
 /**
  * Setup 工具 re-export（plugin-sdk/setup + plugin-sdk/setup-tools）
  *
- * 构建基线 openclaw 2026.9.2，两个 subpath 均为正式导出，直接转发。
+ * 构建基线 openclaw 2026.9.1，两个 subpath 均为正式导出，直接转发。
  */
 export type { ChannelSetupWizard } from 'openclaw/plugin-sdk/setup';
 

package/src/dispatch/ctx-builder.ts

@@ -89,7 +89,26 @@ export function buildCtxPayload(params: CtxPayloadParams): any {
     },
     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
+        : undefined,
       originatingTo: envelope.targetId,
     },
     access: {
@@ -100,8 +119,17 @@ export function buildCtxPayload(params: CtxPayloadParams): any {
       : undefined,
     media: mediaFacts.length > 0 ? mediaFacts : undefined,
     supplemental: {
+      // quote.id 同样必须是「被引用消息」的真实 ID（ref-index 命中时），
+      // 而非当前消息 ID——框架经 applySupplementalContext 映射为
+      // ctx.ReplyToId / "Reply target of current user message"。
       quote: envelope.quote
-        ? { id: envelope.messageId, body: envelope.quote.content, sender: envelope.quote.senderId }
+        ? {
+            ...(envelope.quote.messageId && envelope.quote.messageId !== envelope.messageId
+              ? { id: envelope.quote.messageId }
+              : {}),
+            body: envelope.quote.content,
+            sender: envelope.quote.senderId,
+          }
         : undefined,
       groupSystemPrompt: envelope.systemPrompt,
     },

package/src/dispatch/dispatch.ts

@@ -97,7 +97,7 @@ export async function dispatchToOpenClaw(
   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;
   }
 

package/src/dispatch/envelope-builder.ts

@@ -20,7 +20,7 @@ export interface OpenClawInboundMessage {
   messageId: string;
   content: string;
   history?: Array<{ role: string; content: string; senderId?: string; senderName?: string }>;
-  quote?: { content: string; senderId: string; attachments?: unknown[] };
+  quote?: { content: string; senderId: string; messageId?: string; attachments?: unknown[] };
   attachments?: unknown[];
   /** 入站图片 URL 列表（从附件中提取） */
   imageUrls?: string[];
@@ -44,7 +44,11 @@ function mapHistory(
 }
 
 /**
- * 将 ResolvedQuote 转换为 OpenClaw quote 格式
+ * 将 ResolvedQuote 转换为 OpenClaw quote 格式。
+ *
+ * messageId 为被引用消息的真实平台消息 ID：仅 ref-index store 命中
+ * （quote.source === 'store'，entry 存在）时可取；msg_elements 兜底
+ * 解析拿不到 id，保持 undefined —— 此时框架不渲染 reply_to_id。
  */
 function mapQuote(
   quote: ResolvedQuote | undefined,
@@ -53,6 +57,7 @@ function mapQuote(
   return {
     content: quote.text,
     senderId: quote.entry?.senderId ?? '',
+    messageId: quote.entry?.messageId,
     attachments: quote.attachments as unknown[],
   };
 }

package/src/features/question-helpers.ts

@@ -74,7 +74,7 @@ let questionRuntimePromise: Promise<QuestionGatewayRuntime> | undefined;
 
 /**
  * question gateway runtime（openclaw/plugin-sdk/question-gateway-runtime，
- * 2026.8.1+ 稳定导出，peer 已要求 >=2026.9.2）。
+ * 2026.8.1+ 稳定导出，peer 已要求 >=2026.9.1）。
  */
 export function getQuestionGatewayRuntime(): Promise<QuestionGatewayRuntime> {
   questionRuntimePromise ??= import('openclaw/plugin-sdk/question-gateway-runtime')

package/src/openclaw-plugin-sdk.d.ts

@@ -536,7 +536,7 @@ declare module "openclaw/plugin-sdk" {
 }
 
 // 2026.8.1-beta 起 openclaw 发布包明确排除该子路径的 .d.ts（files 列表
-// "!dist/plugin-sdk/text-utility-runtime.d.ts"），2026.9.2 仍未恢复，运行时导出仍在。
+// "!dist/plugin-sdk/text-utility-runtime.d.ts"），2026.9.1/2026.9.2 均未恢复，运行时导出仍在。
 // 仅声明本项目实际使用的函数（签名对齐 dist/utf16-slice-*.js）。
 declare module "openclaw/plugin-sdk/text-utility-runtime" {
   export function truncateUtf16Safe(input: string, maxLen: number): string;

package/src/utils/pkg-version.ts

@@ -16,7 +16,7 @@ export function getPackageVersion(): string {
 }
 
 /**
- * OpenClaw 框架版本（PluginRuntime.version，peer >=2026.9.2 恒存在）。
+ * OpenClaw 框架版本（PluginRuntime.version，peer >=2026.9.1 恒存在）。
  */
 export function getOpenclawVersion(runtimeVersion?: string): string {
   return runtimeVersion && runtimeVersion !== 'unknown' ? runtimeVersion : 'unknown';