@openclaw/qqbot 2026.6.5 → 2026.6.6-beta.2

package/dist/api.js

@@ -1,8 +1,8 @@
-import { t as qqbotPlugin } from "./channel-D13iTVCr.js";
+import { t as qqbotPlugin } from "./channel-CIb8DUm3.js";
 import { a as resolveQQBotAccount, i as resolveDefaultQQBotAccountId, n as applyQQBotAccountConfig, r as listQQBotAccountIds, t as DEFAULT_ACCOUNT_ID } from "./config-ZEfgeoL4.js";
 import { t as qqbotSetupPlugin } from "./channel.setup-CQ_DFfPx.js";
-import { t as getFrameworkCommands } from "./slash-commands-impl-FRw-Dl44.js";
+import { t as getFrameworkCommands } from "./slash-commands-impl-DVApdSop.js";
 import { n as registerRemindTool, r as registerChannelTool, t as registerQQBotTools } from "./tools-2d9t-N1b.js";
-import { t as registerQQBotFull } from "./channel-entry-fUBLXKPr.js";
+import { t as registerQQBotFull } from "./channel-entry-CfzBEypJ.js";
 import { C as getMessageReplyStats, D as setOutboundAudioPort, E as OUTBOUND_ERROR_CODES, S as getMessageReplyConfig, T as DEFAULT_MEDIA_SEND_ERROR, _ as sendVideoMsg, a as sendText, b as MESSAGE_REPLY_LIMIT, f as buildMediaTarget, g as sendPhoto, h as sendDocument, i as sendProactiveMessage, m as resolveOutboundMediaPath, n as sendCronMessage, p as parseTarget, r as sendMedia, v as sendVoice, w as recordMessageReply, x as checkMessageReplyLimit, y as resolveUserFacingMediaError } from "./outbound-C9wV892v.js";
 export { DEFAULT_ACCOUNT_ID, DEFAULT_MEDIA_SEND_ERROR, MESSAGE_REPLY_LIMIT, OUTBOUND_ERROR_CODES, applyQQBotAccountConfig, buildMediaTarget, checkMessageReplyLimit, getFrameworkCommands, getMessageReplyConfig, getMessageReplyStats, listQQBotAccountIds, parseTarget, qqbotPlugin, qqbotSetupPlugin, recordMessageReply, registerChannelTool, registerQQBotFull, registerQQBotTools, registerRemindTool, resolveDefaultQQBotAccountId, resolveOutboundMediaPath, resolveQQBotAccount, resolveUserFacingMediaError, sendCronMessage, sendDocument, sendMedia, sendPhoto, sendProactiveMessage, sendText, sendVideoMsg, sendVoice, setOutboundAudioPort };

package/dist/{channel-D13iTVCr.js → channel-CIb8DUm3.js}

@@ -377,7 +377,7 @@ function createQQBotApprovalCapability() {
 			},
 			load: async () => {
 				ensurePlatformAdapter();
-				return (await import("./handler-runtime-DZXDF0GH.js")).qqbotApprovalNativeRuntime;
+				return (await import("./handler-runtime-ChANl8Bb.js")).qqbotApprovalNativeRuntime;
 			}
 		})
 	});
@@ -667,7 +667,7 @@ function resolveQQBotGroupToolPolicy(params) {
 //#region extensions/qqbot/src/channel.ts
 let gatewayModulePromise;
 function loadGatewayModule() {
-	gatewayModulePromise ??= import("./gateway-DcL6jnps.js");
+	gatewayModulePromise ??= import("./gateway-fUg0QRoq.js");
 	return gatewayModulePromise;
 }
 let outboundMessagingModulePromise;

package/dist/{channel-entry-fUBLXKPr.js → channel-entry-CfzBEypJ.js}

@@ -1,5 +1,5 @@
 import { a as resolveQQBotAccount } from "./config-ZEfgeoL4.js";
-import { t as getFrameworkCommands } from "./slash-commands-impl-FRw-Dl44.js";
+import { t as getFrameworkCommands } from "./slash-commands-impl-DVApdSop.js";
 import { t as registerQQBotTools } from "./tools-2d9t-N1b.js";
 import { h as sendDocument } from "./outbound-C9wV892v.js";
 //#region extensions/qqbot/src/bridge/commands/framework-context-adapter.ts

package/dist/channel-entry-api.js

@@ -1,2 +1,2 @@
-import { t as registerQQBotFull } from "./channel-entry-fUBLXKPr.js";
+import { t as registerQQBotFull } from "./channel-entry-CfzBEypJ.js";
 export { registerQQBotFull };

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as qqbotPlugin } from "./channel-D13iTVCr.js";
+import { t as qqbotPlugin } from "./channel-CIb8DUm3.js";
 export { qqbotPlugin };

package/dist/{gateway-DcL6jnps.js → gateway-fUg0QRoq.js}

@@ -1,12 +1,12 @@
 import { C as getNextMsgSeq, D as downloadFile, F as StreamInputMode, I as StreamInputState, M as getMaxUploadSize, P as StreamContentType, T as openLocalFile, a as createRawInputNotifyFn, b as stopBackgroundTokenRefresh, c as getMessageApi, d as initSender, f as onMessageSent, g as sendText, h as sendMedia, i as clearTokenCache, j as getImageMimeType, k as formatFileSize, l as getPluginUserAgent, m as sendInputNotify, n as acknowledgeInteraction, o as getAccessToken, p as registerAccount, r as buildDeliveryTarget, s as getGatewayUrl, t as accountToCreds, u as initApiConfig, x as withTokenRetry, y as startBackgroundTokenRefresh } from "./sender-DIMG7jHz.js";
 import { c as getPlatformAdapter, i as normalizeOptionalString$1, n as normalizeLowercaseStringOrEmpty$1, o as readStringField, s as sanitizeFileName, t as asOptionalObjectRecord } from "./string-normalize-R_0cKO7Q.js";
 import { c as setBridgeLogger, o as ensurePlatformAdapter } from "./config-schema-BFLNZ8Nf.js";
-import { a as authorizeQQBotApprovalAction, i as toGatewayAccount, n as buildQQBotStateKey, p as parseApprovalButtonData, r as openQQBotSyncKeyedStore } from "./channel-D13iTVCr.js";
+import { a as authorizeQQBotApprovalAction, i as toGatewayAccount, n as buildQQBotStateKey, p as parseApprovalButtonData, r as openQQBotSyncKeyedStore } from "./channel-CIb8DUm3.js";
 import { d as resolveAccountBase } from "./config-ZEfgeoL4.js";
 import { a as formatErrorMessage, i as formatDuration, n as debugLog, r as debugWarn, t as debugError } from "./log-SDfMMBWe.js";
 import { n as getQQBotRuntimeForEngine, t as getQQBotRuntime } from "./runtime-B9UoQ5NI.js";
 import { a as getHomeDir, c as getQQBotMediaDir, d as isLocalPath, f as isWindows, i as checkSilkWasmAvailable, m as resolveQQBotPayloadLocalFilePath, o as getQQBotDataDir, p as normalizePath, s as getQQBotDataPath, u as getTempDir } from "./target-parser-BdCUmxK7.js";
-import { a as matchSlashCommand, i as initCommands, n as getFrameworkVersion, r as getPluginVersion } from "./slash-commands-impl-FRw-Dl44.js";
+import { a as matchSlashCommand, i as initCommands, n as getFrameworkVersion, r as getPluginVersion } from "./slash-commands-impl-DVApdSop.js";
 import { n as runWithRequestContext } from "./request-context-Bm7PTBD1.js";
 import { D as setOutboundAudioPort, T as DEFAULT_MEDIA_SEND_ERROR, _ as sendVideoMsg, c as isCronReminderPayload, d as normalizeMediaTags, g as sendPhoto, h as sendDocument, l as isMediaPayload, o as decodeMediaPath, r as sendMedia$1, s as encodePayloadForCron, u as parseQQBotPayload, v as sendVoice, y as resolveUserFacingMediaError } from "./outbound-C9wV892v.js";
 import { asBoolean, uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
@@ -21,11 +21,12 @@ import * as path$1 from "node:path";
 import path from "node:path";
 import { mimeTypeFromFilePath } from "openclaw/plugin-sdk/media-mime";
 import { MAX_TIMER_TIMEOUT_MS, finiteSecondsToTimerSafeMilliseconds } from "openclaw/plugin-sdk/number-runtime";
-import { resolveRuntimeServiceVersion } from "openclaw/plugin-sdk/cli-runtime";
 import { getRuntimeConfig } from "openclaw/plugin-sdk/runtime-config-snapshot";
+import { resolveRuntimeServiceVersion } from "openclaw/plugin-sdk/cli-runtime";
 import WebSocket from "ws";
 import { resolveAmbientNodeProxyAgent } from "openclaw/plugin-sdk/extension-shared";
 import { buildChannelInboundEventContext } from "openclaw/plugin-sdk/channel-inbound";
+import { SILENT_REPLY_TOKEN, isSilentReplyPayloadText } from "openclaw/plugin-sdk/reply-chunking";
 import { Buffer as Buffer$1 } from "node:buffer";
 import { fileURLToPath } from "node:url";
 import { parseAccessGroupAllowFromEntry } from "openclaw/plugin-sdk/access-groups";
@@ -2595,11 +2596,13 @@ function readHistoryLimit(obj, key) {
 	return Math.max(0, Math.floor(v));
 }
 function resolveGroupConfig(cfg, groupOpenid, accountId) {
+	const account = resolveAccountBase(cfg, accountId);
 	const groups = readGroupsMap(cfg, accountId);
 	const wildcard = groups["*"] ?? {};
 	const specific = groupOpenid ? groups[groupOpenid] ?? {} : {};
+	const accountDefaultRequireMention = asBoolean(account.config.defaultRequireMention) ?? DEFAULT_GROUP_CONFIG.requireMention;
 	return {
-		requireMention: readBoolean(specific, "requireMention") ?? readBoolean(wildcard, "requireMention") ?? DEFAULT_GROUP_CONFIG.requireMention,
+		requireMention: readBoolean(specific, "requireMention") ?? readBoolean(wildcard, "requireMention") ?? accountDefaultRequireMention,
 		ignoreOtherMentions: readBoolean(specific, "ignoreOtherMentions") ?? readBoolean(wildcard, "ignoreOtherMentions") ?? DEFAULT_GROUP_CONFIG.ignoreOtherMentions,
 		name: readString(specific, "name") ?? readString(wildcard, "name") ?? DEFAULT_GROUP_CONFIG.name,
 		prompt: readString(specific, "prompt") ?? readString(wildcard, "prompt"),
@@ -5734,6 +5737,19 @@ function immediateToolProgressText(payload) {
 	if (payload.mediaUrl || payload.mediaUrls?.length) return;
 	return text;
 }
+function hasReplyMedia(payload) {
+	return Boolean(payload.mediaUrl || payload.mediaUrls?.length);
+}
+function isSilentBlockReplyText(text) {
+	return !text || text === "[SKIP]" || isSilentReplyPayloadText(text, SILENT_REPLY_TOKEN);
+}
+function blockReplyTextForDelivery(payload) {
+	const text = payload.text ?? "";
+	return isSilentBlockReplyText(text.trim()) ? "" : text;
+}
+function isSilentBlockReply(payload) {
+	return !hasReplyMedia(payload) && isSilentBlockReplyText((payload.text ?? "").trim());
+}
 /**
 * Dispatch the AI reply for the given inbound context.
 *
@@ -5761,50 +5777,78 @@ async function dispatchOutbound(inbound, deps) {
 	const ctxPayload = await buildCtxPayload(inbound, runtime, cfg);
 	let hasResponse = false;
 	let hasBlockResponse = false;
+	let hasVisibleBlockResponse = false;
 	let toolDeliverCount = 0;
 	const toolTexts = [];
 	const toolMediaUrls = [];
 	let toolFallbackSent = false;
 	let toolRenewalCount = 0;
+	let skippedSilentBlockResponse = false;
 	let timeoutId = null;
 	let toolOnlyTimeoutId = null;
+	const markBlockResponse = () => {
+		hasBlockResponse = true;
+		inbound.typing.keepAlive?.stop();
+		if (timeoutId) {
+			clearTimeout(timeoutId);
+			timeoutId = null;
+		}
+		if (toolOnlyTimeoutId) {
+			clearTimeout(toolOnlyTimeoutId);
+			toolOnlyTimeoutId = null;
+		}
+	};
+	const sendToolMediaWithTimeout = async (mediaUrl, labels) => {
+		const ac = new AbortController();
+		let mediaTimeoutId = null;
+		try {
+			const result = await Promise.race([sendMedia$1({
+				to: qualifiedTarget,
+				text: "",
+				mediaUrl,
+				accountId: account.accountId,
+				replyToId: event.messageId,
+				account
+			}).then((r) => {
+				if (ac.signal.aborted) return {
+					channel: "qqbot",
+					error: "suppressed"
+				};
+				return r;
+			}), new Promise((resolve) => {
+				mediaTimeoutId = setTimeout(() => {
+					ac.abort();
+					resolve({
+						channel: "qqbot",
+						error: "timeout"
+					});
+				}, TOOL_MEDIA_SEND_TIMEOUT);
+			})]);
+			if (result.error) log?.error(`${labels.resultError}: ${result.error}`);
+		} catch (err) {
+			log?.error(`${labels.thrownError}: ${String(err)}`);
+		} finally {
+			if (mediaTimeoutId) clearTimeout(mediaTimeoutId);
+		}
+	};
 	const sendToolFallback = async () => {
 		if (toolMediaUrls.length > 0) {
-			for (const mediaUrl of toolMediaUrls) {
-				const ac = new AbortController();
-				try {
-					const result = await Promise.race([sendMedia$1({
-						to: qualifiedTarget,
-						text: "",
-						mediaUrl,
-						accountId: account.accountId,
-						replyToId: event.messageId,
-						account
-					}).then((r) => {
-						if (ac.signal.aborted) return {
-							channel: "qqbot",
-							error: "suppressed"
-						};
-						return r;
-					}), new Promise((resolve) => {
-						setTimeout(() => {
-							ac.abort();
-							resolve({
-								channel: "qqbot",
-								error: "timeout"
-							});
-						}, TOOL_MEDIA_SEND_TIMEOUT);
-					})]);
-					if (result.error) log?.error(`Tool fallback error: ${result.error}`);
-				} catch (err) {
-					log?.error(`Tool fallback failed: ${String(err)}`);
-				}
-			}
+			for (const mediaUrl of toolMediaUrls) await sendToolMediaWithTimeout(mediaUrl, {
+				resultError: "Tool fallback error",
+				thrownError: "Tool fallback failed"
+			});
 			return;
 		}
 		if (toolTexts.length > 0) await sendErrorMessage(toolTexts.slice(-3).join("\n---\n").slice(0, 2e3));
 	};
 	const hasPendingToolFallbackPayload = () => toolTexts.length > 0 || toolMediaUrls.length > 0;
+	const flushPendingToolDeliveriesOnce = async () => {
+		if (toolFallbackSent || !hasPendingToolFallbackPayload()) return false;
+		await flushPendingToolDeliveries();
+		toolFallbackSent = true;
+		recordOutbound();
+		return true;
+	};
 	const renewToolOnlyFallback = () => {
 		if (toolFallbackSent) return false;
 		if (toolOnlyTimeoutId) {
@@ -5813,7 +5857,7 @@ async function dispatchOutbound(inbound, deps) {
 			toolRenewalCount++;
 		}
 		toolOnlyTimeoutId = setTimeout(() => {
-			if (!hasBlockResponse && !toolFallbackSent) {
+			if (!hasBlockResponse && !toolFallbackSent && !skippedSilentBlockResponse) {
 				toolFallbackSent = true;
 				sendToolFallback().catch(() => {});
 			}
@@ -5840,6 +5884,32 @@ async function dispatchOutbound(inbound, deps) {
 		textToSpeech: (params) => runtime.tts.textToSpeech(params),
 		audioFileToSilkBase64: async (p) => await audioFileToSilkBase64(p) ?? void 0
 	} };
+	const flushPendingToolDeliveries = async () => {
+		if (toolMediaUrls.length > 0) {
+			const urlsToSend = [...toolMediaUrls];
+			toolMediaUrls.length = 0;
+			for (const mediaUrl of urlsToSend) await sendToolMediaWithTimeout(mediaUrl, {
+				resultError: "Tool media forward error",
+				thrownError: "Tool media forward failed"
+			});
+		}
+		if (toolTexts.length > 0) {
+			const textsToSend = [...toolTexts];
+			toolTexts.length = 0;
+			for (const text of textsToSend) await sendTextOnlyReply(text, {
+				type: event.type,
+				senderId: event.senderId,
+				messageId: event.messageId,
+				channelId: event.channelId,
+				groupOpenid: event.groupOpenid,
+				msgIdx: event.msgIdx
+			}, {
+				account,
+				qualifiedTarget,
+				log
+			}, sendWithRetry, () => void 0, deliverDeps);
+		}
+	};
 	const recordOutbound = () => runtime.channel.activity.record({
 		channel: "qqbot",
 		accountId: account.accountId,
@@ -5943,16 +6013,12 @@ async function dispatchOutbound(inbound, deps) {
 								renewToolOnlyFallback();
 								return;
 							}
-							hasBlockResponse = true;
-							inbound.typing.keepAlive?.stop();
-							if (timeoutId) {
-								clearTimeout(timeoutId);
-								timeoutId = null;
-							}
-							if (toolOnlyTimeoutId) {
-								clearTimeout(toolOnlyTimeoutId);
-								toolOnlyTimeoutId = null;
+							markBlockResponse();
+							if (!streamingController && isSilentBlockReply(payload)) {
+								if (!await flushPendingToolDeliveriesOnce() && event.type === "group") log?.info(`Model decided to skip group message (${(payload.text ?? "").trim() || "empty reply"}) from ${event.senderId}`);
+								return;
 							}
+							hasVisibleBlockResponse = true;
 							if (streamingController && !streamingController.isTerminalPhase) {
 								try {
 									await streamingController.onDeliver(payload);
@@ -5978,7 +6044,7 @@ async function dispatchOutbound(inbound, deps) {
 									return quoteRef;
 								}
 							};
-							let replyText = payload.text ?? "";
+							let replyText = blockReplyTextForDelivery(payload);
 							const deliverEvent = {
 								type: event.type,
 								senderId: event.senderId,
@@ -6025,6 +6091,15 @@ async function dispatchOutbound(inbound, deps) {
 								clearTimeout(timeoutId);
 								timeoutId = null;
 							}
+						},
+						onSkip: (_payload, info) => {
+							if (!streamingController && (info.kind === "block" || info.kind === "final") && (info.reason === "silent" || info.reason === "empty")) skippedSilentBlockResponse = true;
+						},
+						onFreshSettledDelivery: async () => {
+							if (skippedSilentBlockResponse && !hasVisibleBlockResponse) {
+								markBlockResponse();
+								if (await flushPendingToolDeliveriesOnce()) return { visibleReplySent: true };
+							}
 						}
 					},
 					replyOptions: {
@@ -6048,13 +6123,20 @@ async function dispatchOutbound(inbound, deps) {
 	try {
 		await Promise.race([dispatchPromise, timeoutPromise]);
 	} catch {
-		if (timeoutId) clearTimeout(timeoutId);
+		if (timeoutId) {
+			clearTimeout(timeoutId);
+			timeoutId = null;
+		}
 	} finally {
+		if (timeoutId) {
+			clearTimeout(timeoutId);
+			timeoutId = null;
+		}
 		if (toolOnlyTimeoutId) {
 			clearTimeout(toolOnlyTimeoutId);
 			toolOnlyTimeoutId = null;
 		}
-		if (toolDeliverCount > 0 && !hasBlockResponse && !toolFallbackSent) {
+		if (toolDeliverCount > 0 && !hasBlockResponse && !toolFallbackSent && !skippedSilentBlockResponse) {
 			toolFallbackSent = true;
 			await sendToolFallback();
 		}

package/dist/{handler-runtime-DZXDF0GH.js → handler-runtime-ChANl8Bb.js}

@@ -1,6 +1,6 @@
 import { c as getMessageApi, t as accountToCreds } from "./sender-DIMG7jHz.js";
 import { o as ensurePlatformAdapter, s as getBridgeLogger } from "./config-schema-BFLNZ8Nf.js";
-import { c as resolveQQBotExecApprovalConfig, d as buildExecApprovalText, f as buildPluginApprovalText, l as shouldHandleQQBotExecApprovalRequest, m as resolveApprovalTarget, o as isQQBotExecApprovalClientEnabled, s as matchesQQBotApprovalAccount, u as buildApprovalKeyboard } from "./channel-D13iTVCr.js";
+import { c as resolveQQBotExecApprovalConfig, d as buildExecApprovalText, f as buildPluginApprovalText, l as shouldHandleQQBotExecApprovalRequest, m as resolveApprovalTarget, o as isQQBotExecApprovalClientEnabled, s as matchesQQBotApprovalAccount, u as buildApprovalKeyboard } from "./channel-CIb8DUm3.js";
 import { a as resolveQQBotAccount } from "./config-ZEfgeoL4.js";
 import { resolveApprovalRequestSessionConversation } from "openclaw/plugin-sdk/approval-native-runtime";
 import { createChannelApprovalNativeRuntimeAdapter } from "openclaw/plugin-sdk/approval-handler-runtime";

package/dist/{slash-commands-impl-FRw-Dl44.js → slash-commands-impl-DVApdSop.js}

@@ -4,6 +4,7 @@ import { uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
 import fs from "node:fs";
 import path from "node:path";
 import { loadJsonFile } from "openclaw/plugin-sdk/json-store";
+import { clearRuntimeConfigSnapshot } from "openclaw/plugin-sdk/runtime-config-snapshot";
 //#region extensions/qqbot/src/engine/commands/builtin/state.ts
 let resolveVersionGetter = () => "unknown";
 let approveRuntimeGetter = null;
@@ -418,6 +419,88 @@ function registerClearStorageCommands(registry) {
 	});
 }
 //#endregion
+//#region extensions/qqbot/src/engine/commands/builtin/register-group-allways.ts
+function registerGroupAllwaysCommand(registry) {
+	registry.register({
+		name: "bot-group-allways",
+		description: "修改群消息默认响应模式",
+		requireAuth: true,
+		c2cOnly: true,
+		usage: [
+			`/bot-group-allways on   AI 自主判断何时发言（无需 @）`,
+			`/bot-group-allways off  仅在被 @ 时回复`,
+			`/bot-group-allways      查看当前设置`,
+			``,
+			`设为 on 后，AI 会自主判断每条消息是否需要回复（无需 @）。`,
+			`仍可通过 groups.{groupId}.requireMention 对单个群覆盖。`,
+			``,
+			`优先级：具体群配置 > 通配符 "*" > defaultRequireMention（本指令）> 默认 true`
+		].join("\n"),
+		handler: async (ctx) => {
+			const arg = ctx.args.trim().toLowerCase();
+			const currentRequireMention = ctx.accountConfig?.defaultRequireMention ?? true;
+			if (!arg) return [
+				`🤖 群自主发言状态：${currentRequireMention ? "❌ 仅被 @ 时回复" : "✅ 自主判断何时发言"}`,
+				`使用 <qqbot-cmd-input text="/bot-group-allways on" show="/bot-group-allways on"/> 设为自主发言`,
+				`使用 <qqbot-cmd-input text="/bot-group-allways off" show="/bot-group-allways off"/> 设为仅被 @ 时回复`
+			].join("\n");
+			if (arg !== "on" && arg !== "off") return `❌ 参数错误，请使用 on 或 off\n\n示例：/bot-group-allways on`;
+			const newRequireMention = arg === "off";
+			if (newRequireMention === currentRequireMention) return `🤖 群自主发言已经是"${arg}"状态，无需操作`;
+			let runtime;
+			try {
+				const getter = getApproveRuntimeGetter();
+				if (!getter) throw new Error("runtime not available");
+				runtime = getter();
+			} catch {
+				const fwVer = resolveRuntimeServiceVersion();
+				const ver = getPluginVersionString();
+				return [
+					`❌ 当前版本不支持该指令`,
+					``,
+					`🦞框架版本：${fwVer}`,
+					`🤖QQBot 插件版本：v${ver}`,
+					``,
+					`可通过以下命令手动设置：`,
+					``,
+					`\`\`\`shell`,
+					`# 设为 AI 自主判断何时发言（defaultRequireMention=false）`,
+					`openclaw config set channels.qqbot.defaultRequireMention false`,
+					`# 或设为仅被 @ 时回复（defaultRequireMention=true）`,
+					`openclaw config set channels.qqbot.defaultRequireMention true`,
+					`\`\`\``
+				].join("\n");
+			}
+			try {
+				const configApi = runtime.config;
+				const currentCfg = structuredClone(configApi.current());
+				const qqbot = (currentCfg.channels ?? {}).qqbot;
+				if (!qqbot) return `❌ 配置文件中未找到 qqbot 通道配置`;
+				const accountId = ctx.accountId;
+				if (accountId !== "default" && Boolean(qqbot.accounts?.[accountId])) {
+					const nextAccounts = { ...qqbot.accounts ?? {} };
+					const acct = { ...nextAccounts[accountId] };
+					acct.defaultRequireMention = newRequireMention;
+					nextAccounts[accountId] = acct;
+					qqbot.accounts = nextAccounts;
+				} else qqbot.defaultRequireMention = newRequireMention;
+				await configApi.replaceConfigFile({
+					nextConfig: currentCfg,
+					afterWrite: { mode: "auto" }
+				});
+				clearRuntimeConfigSnapshot();
+				return [
+					`✅ 群自主发言已设置为 ${newRequireMention ? "**off**（仅被 @ 时回复）" : "**on**（AI 自主判断何时发言）"}`,
+					``,
+					newRequireMention ? `仅在被 @ 机器人才会回复。` : `AI 将自主判断群消息是否需要回复，无需被 @ 即可发言。`
+				].join("\n");
+			} catch (err) {
+				return `❌ 配置写入失败: ${err instanceof Error ? err.message : String(err)}`;
+			}
+		}
+	});
+}
+//#endregion
 //#region extensions/qqbot/src/engine/commands/builtin/log-helpers.ts
 /** Read user-configured log file paths from local config files. */
 function getConfiguredLogFiles() {
@@ -790,6 +873,7 @@ function registerBuiltinSlashCommands(registry) {
 	registerClearStorageCommands(registry);
 	registerStreamingCommands(registry);
 	registerApproveCommands(registry);
+	registerGroupAllwaysCommand(registry);
 }
 //#endregion
 //#region extensions/qqbot/src/engine/commands/slash-commands.ts

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
   "name": "@openclaw/qqbot",
-  "version": "2026.6.5",
+  "version": "2026.6.6-beta.2",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@openclaw/qqbot",
-      "version": "2026.6.5",
+      "version": "2026.6.6-beta.2",
       "dependencies": {
         "@tencent-connect/qqbot-connector": "1.1.0",
         "mpg123-decoder": "1.0.3",
@@ -15,7 +15,7 @@
         "zod": "4.4.3"
       },
       "peerDependencies": {
-        "openclaw": ">=2026.6.5"
+        "openclaw": ">=2026.6.6-beta.2"
       },
       "peerDependenciesMeta": {
         "openclaw": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/qqbot",
-  "version": "2026.6.5",
+  "version": "2026.6.6-beta.2",
   "private": false,
   "description": "OpenClaw QQ Bot channel plugin for group and direct-message workflows.",
   "repository": {
@@ -16,7 +16,7 @@
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.6.5"
+    "openclaw": ">=2026.6.6-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -45,10 +45,10 @@
       "minHostVersion": ">=2026.4.10"
     },
     "compat": {
-      "pluginApi": ">=2026.6.5"
+      "pluginApi": ">=2026.6.6-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.6.5"
+      "openclawVersion": "2026.6.6-beta.2"
     },
     "release": {
       "publishToClawHub": true,