@openclaw/qqbot 2026.5.14-beta.1 → 2026.5.14-beta.2

package/dist/channel-plugin-api.js

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

package/dist/{channel.setup-DWWV_GAa.js → channel.setup-D_8Ryfln.js}

@@ -1,5 +1,4 @@
-import "./config-DiBiPtf4.js";
-import { a as qqbotSetupAdapterShared, i as qqbotMeta, n as qqbotSetupWizard, r as qqbotConfigAdapter, t as qqbotChannelConfigSchema } from "./config-schema-BeJQUheK.js";
+import { a as qqbotSetupAdapterShared, i as qqbotMeta, n as qqbotSetupWizard, r as qqbotConfigAdapter, t as qqbotChannelConfigSchema } from "./config-schema-BE5YP0NG.js";
 //#region extensions/qqbot/src/channel.setup.ts
 /**
 * Setup-only QQBot plugin — lightweight subset used during `openclaw onboard`

package/dist/{config-DiBiPtf4.js → config-schema-BE5YP0NG.js}

@@ -1,8 +1,13 @@
-import { a as normalizeStringifiedOptionalString, c as getPlatformAdapter, d as registerPlatformAdapterFactory, l as hasPlatformAdapter, o as readStringField, r as normalizeOptionalLowercaseString, t as asOptionalObjectRecord, u as registerPlatformAdapter } from "./string-normalize-C46CS-F1.js";
-import { coerceSecretRef, hasConfiguredSecretInput, normalizeResolvedSecretInputString, normalizeSecretInputString } from "openclaw/plugin-sdk/secret-input";
+import { a as normalizeStringifiedOptionalString, c as getPlatformAdapter, d as registerPlatformAdapterFactory, l as hasPlatformAdapter, n as normalizeLowercaseStringOrEmpty, o as readStringField, r as normalizeOptionalLowercaseString, t as asOptionalObjectRecord, u as registerPlatformAdapter } from "./string-normalize-C46CS-F1.js";
+import { buildSecretInputSchema, coerceSecretRef, hasConfiguredSecretInput, normalizeResolvedSecretInputString, normalizeSecretInputString } from "openclaw/plugin-sdk/secret-input";
 import { resolvePreferredOpenClawTmpDir } from "openclaw/plugin-sdk/temp-path";
 import fs from "node:fs";
 import { resolveDefaultSecretProviderAlias } from "openclaw/plugin-sdk/provider-auth";
+import { applyAccountNameToChannelSection, deleteAccountFromConfigSection, setAccountEnabledInConfigSection } from "openclaw/plugin-sdk/core";
+import { DEFAULT_ACCOUNT_ID, createStandardChannelSetupStatus, setSetupChannelEnabled } from "openclaw/plugin-sdk/setup";
+import { formatDocsLink } from "openclaw/plugin-sdk/setup-tools";
+import { AllowFromListSchema, buildChannelConfigSchema } from "openclaw/plugin-sdk/channel-config-schema";
+import { z } from "zod";
 //#region extensions/qqbot/src/bridge/logger.ts
 let _logger = null;
 /** Register the framework logger. Called once in startGateway(). */
@@ -133,7 +138,7 @@ ensurePlatformAdapter();
 * Default account ID, used for the unnamed top-level account.
 * 默认账号 ID，用于顶层配置中未命名的账号。
 */
-const DEFAULT_ACCOUNT_ID$1 = "default";
+const DEFAULT_ACCOUNT_ID$2 = "default";
 function normalizeAppId(raw) {
 	if (typeof raw === "string") return raw.trim();
 	if (typeof raw === "number") return String(raw);
@@ -157,7 +162,7 @@ function readQQBotSection(cfg) {
 function listAccountIds(cfg) {
 	const ids = /* @__PURE__ */ new Set();
 	const qqbot = readQQBotSection(cfg);
-	if (qqbot?.appId || process.env.QQBOT_APP_ID) ids.add(DEFAULT_ACCOUNT_ID$1);
+	if (qqbot?.appId || process.env.QQBOT_APP_ID) ids.add(DEFAULT_ACCOUNT_ID$2);
 	if (qqbot?.accounts) {
 		for (const accountId of Object.keys(qqbot.accounts)) if (qqbot.accounts[accountId]?.appId) ids.add(accountId);
 	}
@@ -171,12 +176,12 @@ function resolveDefaultAccountId(cfg) {
 	const qqbot = readQQBotSection(cfg);
 	const configuredDefaultAccountId = normalizeOptionalLowercaseString(qqbot?.defaultAccount);
 	if (configuredDefaultAccountId && (configuredDefaultAccountId === "default" || Boolean(qqbot?.accounts?.[configuredDefaultAccountId]?.appId))) return configuredDefaultAccountId;
-	if (qqbot?.appId || process.env.QQBOT_APP_ID) return DEFAULT_ACCOUNT_ID$1;
+	if (qqbot?.appId || process.env.QQBOT_APP_ID) return DEFAULT_ACCOUNT_ID$2;
 	if (qqbot?.accounts) {
 		const ids = Object.keys(qqbot.accounts);
 		if (ids.length > 0) return ids[0];
 	}
-	return DEFAULT_ACCOUNT_ID$1;
+	return DEFAULT_ACCOUNT_ID$2;
 }
 /**
 * Resolve base account info (without credentials).
@@ -284,7 +289,7 @@ function formatAllowFrom(allowFrom) {
 }
 //#endregion
 //#region extensions/qqbot/src/bridge/config.ts
-const DEFAULT_ACCOUNT_ID = DEFAULT_ACCOUNT_ID$1;
+const DEFAULT_ACCOUNT_ID$1 = DEFAULT_ACCOUNT_ID$2;
 function assertNotLegacySecretRefMarker(value, path) {
 	const normalized = normalizeSecretInputString(value);
 	if (!normalized || !/^secretref(?:-env)?:/i.test(normalized)) return;
@@ -329,13 +334,13 @@ function resolveQQBotAccount(cfg, accountId, opts) {
 	* fields (allowFrom, streaming, …) often live under `accounts.default`.
 	* Merge that slice so runtime sees `config.streaming` etc.
 	*/
-	const accountConfig = base.accountId === DEFAULT_ACCOUNT_ID ? {
+	const accountConfig = base.accountId === DEFAULT_ACCOUNT_ID$1 ? {
 		...qqbot,
-		...qqbot?.accounts?.[DEFAULT_ACCOUNT_ID]
+		...qqbot?.accounts?.[DEFAULT_ACCOUNT_ID$1]
 	} : qqbot?.accounts?.[base.accountId] ?? {};
 	let clientSecret = "";
 	let secretSource = "none";
-	const clientSecretPath = base.accountId === DEFAULT_ACCOUNT_ID ? "channels.qqbot.clientSecret" : `channels.qqbot.accounts.${base.accountId}.clientSecret`;
+	const clientSecretPath = base.accountId === DEFAULT_ACCOUNT_ID$1 ? "channels.qqbot.clientSecret" : `channels.qqbot.accounts.${base.accountId}.clientSecret`;
 	const adapter = getPlatformAdapter();
 	if (adapter.hasConfiguredSecret(accountConfig.clientSecret)) {
 		clientSecret = opts?.allowUnresolvedSecretRef ? adapter.normalizeSecretInputString(accountConfig.clientSecret) ?? "" : resolveQQBotClientSecretInput({
@@ -350,7 +355,7 @@ function resolveQQBotAccount(cfg, accountId, opts) {
 	} catch {
 		secretSource = "none";
 	}
-	else if (process.env.QQBOT_CLIENT_SECRET && base.accountId === DEFAULT_ACCOUNT_ID) {
+	else if (process.env.QQBOT_CLIENT_SECRET && base.accountId === DEFAULT_ACCOUNT_ID$1) {
 		clientSecret = process.env.QQBOT_CLIENT_SECRET;
 		secretSource = "env";
 	}
@@ -371,4 +376,303 @@ function applyQQBotAccountConfig(cfg, accountId, input) {
 	return applyAccountConfig(cfg, accountId, input);
 }
 //#endregion
-export { resolveQQBotAccount as a, describeAccount as c, resolveAccountBase as d, ensurePlatformAdapter as f, resolveDefaultQQBotAccountId as i, formatAllowFrom as l, setBridgeLogger as m, applyQQBotAccountConfig as n, DEFAULT_ACCOUNT_ID$1 as o, getBridgeLogger as p, listQQBotAccountIds as r, applyAccountConfig as s, DEFAULT_ACCOUNT_ID as t, isAccountConfigured as u };
+//#region extensions/qqbot/src/engine/config/setup-logic.ts
+/**
+* QQBot setup business logic (pure layer).
+* QQBot setup 相关纯业务逻辑。
+*
+* Token parsing, input validation, and setup config application.
+* All functions are framework-agnostic and operate on plain objects.
+*/
+/** Parse an inline "appId:clientSecret" token string. */
+function parseInlineToken(token) {
+	const colonIdx = token.indexOf(":");
+	if (colonIdx <= 0 || colonIdx === token.length - 1) return null;
+	const appId = token.slice(0, colonIdx).trim();
+	const clientSecret = token.slice(colonIdx + 1).trim();
+	if (!appId || !clientSecret) return null;
+	return {
+		appId,
+		clientSecret
+	};
+}
+/** Validate setup input for a QQBot account. Returns an error string or null. */
+function validateSetupInput(accountId, input) {
+	if (!input.token && !input.tokenFile && !input.useEnv) return "QQBot requires --token (format: appId:clientSecret) or --use-env";
+	if (input.useEnv && accountId !== "default") return "QQBot --use-env only supports the default account";
+	if (input.token && !parseInlineToken(input.token)) return "QQBot --token must be in appId:clientSecret format";
+	return null;
+}
+/** Apply setup input to account config. Returns updated config. */
+function applySetupAccountConfig(cfg, accountId, input) {
+	if (input.useEnv && accountId !== "default") return cfg;
+	let appId = "";
+	let clientSecret = "";
+	if (input.token) {
+		const parsed = parseInlineToken(input.token);
+		if (!parsed) return cfg;
+		appId = parsed.appId;
+		clientSecret = parsed.clientSecret;
+	}
+	if (!appId && !input.tokenFile && !input.useEnv) return cfg;
+	return applyAccountConfig(cfg, accountId, {
+		appId,
+		clientSecret,
+		clientSecretFile: input.tokenFile,
+		name: input.name
+	});
+}
+//#endregion
+//#region extensions/qqbot/src/bridge/config-shared.ts
+const qqbotMeta = {
+	id: "qqbot",
+	label: "QQ Bot",
+	selectionLabel: "QQ Bot (Bot API)",
+	docsPath: "/channels/qqbot",
+	blurb: "Connect to QQ via official QQ Bot API",
+	order: 50
+};
+function validateQQBotSetupInput(params) {
+	return validateSetupInput(params.accountId, params.input);
+}
+function applyQQBotSetupAccountConfig(params) {
+	return applySetupAccountConfig(params.cfg, params.accountId, params.input);
+}
+function isQQBotConfigured(account) {
+	return isAccountConfigured(account);
+}
+function describeQQBotAccount(account) {
+	return describeAccount(account);
+}
+function formatQQBotAllowFrom(params) {
+	return formatAllowFrom(params.allowFrom);
+}
+const qqbotConfigAdapter = {
+	listAccountIds: (cfg) => listQQBotAccountIds(cfg),
+	resolveAccount: (cfg, accountId) => resolveQQBotAccount(cfg, accountId, { allowUnresolvedSecretRef: true }),
+	defaultAccountId: (cfg) => resolveDefaultQQBotAccountId(cfg),
+	setAccountEnabled: ({ cfg, accountId, enabled }) => setAccountEnabledInConfigSection({
+		cfg,
+		sectionKey: "qqbot",
+		accountId,
+		enabled,
+		allowTopLevel: true
+	}),
+	deleteAccount: ({ cfg, accountId }) => deleteAccountFromConfigSection({
+		cfg,
+		sectionKey: "qqbot",
+		accountId,
+		clearBaseFields: [
+			"appId",
+			"clientSecret",
+			"clientSecretFile",
+			"name"
+		]
+	}),
+	isConfigured: isQQBotConfigured,
+	describeAccount: describeQQBotAccount,
+	resolveAllowFrom: ({ cfg, accountId }) => resolveQQBotAccount(cfg, accountId, { allowUnresolvedSecretRef: true }).config?.allowFrom,
+	formatAllowFrom: ({ allowFrom }) => formatQQBotAllowFrom({ allowFrom })
+};
+const qqbotSetupAdapterShared = {
+	resolveAccountId: ({ cfg, accountId }) => normalizeLowercaseStringOrEmpty(accountId) || resolveDefaultQQBotAccountId(cfg),
+	applyAccountName: ({ cfg, accountId, name }) => applyAccountNameToChannelSection({
+		cfg,
+		channelKey: "qqbot",
+		accountId,
+		name
+	}),
+	validateInput: ({ accountId, input }) => validateQQBotSetupInput({
+		accountId,
+		input
+	}),
+	applyAccountConfig: ({ cfg, accountId, input }) => applyQQBotSetupAccountConfig({
+		cfg,
+		accountId,
+		input
+	})
+};
+//#endregion
+//#region extensions/qqbot/src/bridge/setup/finalize.ts
+function isQQBotAccountConfigured(cfg, accountId) {
+	const account = resolveQQBotAccount(cfg, accountId, { allowUnresolvedSecretRef: true });
+	return Boolean(account.appId && account.clientSecret);
+}
+async function linkViaQrCode(params) {
+	try {
+		const { qrConnect } = await import("@tencent-connect/qqbot-connector");
+		const accounts = await qrConnect({ source: "openclaw" });
+		if (accounts.length === 0) {
+			await params.prompter.note("未获取到任何 QQ Bot 账号信息。", "QQ Bot");
+			return params.cfg;
+		}
+		let next = params.cfg;
+		for (let i = 0; i < accounts.length; i++) {
+			const { appId, appSecret } = accounts[i];
+			const targetAccountId = i === 0 ? params.accountId : appId;
+			next = applyQQBotAccountConfig(next, targetAccountId, {
+				appId,
+				clientSecret: appSecret
+			});
+		}
+		if (accounts.length === 1) params.runtime.log(`✔ QQ Bot 绑定成功！(AppID: ${accounts[0].appId})`);
+		else {
+			const idList = accounts.map((a) => a.appId).join(", ");
+			params.runtime.log(`✔ ${accounts.length} 个 QQ Bot 绑定成功！(AppID: ${idList})`);
+		}
+		return next;
+	} catch (error) {
+		params.runtime.error(`QQ Bot 绑定失败: ${String(error)}`);
+		await params.prompter.note(["绑定失败，您可以稍后手动配置。", `文档: ${formatDocsLink("/channels/qqbot", "qqbot")}`].join("\n"), "QQ Bot");
+		return params.cfg;
+	}
+}
+async function linkViaManualInput(params) {
+	const appId = await params.prompter.text({
+		message: "请输入 QQ Bot AppID",
+		validate: (value) => value.trim() ? void 0 : "AppID 不能为空"
+	});
+	const appSecret = await params.prompter.text({
+		message: "请输入 QQ Bot AppSecret",
+		validate: (value) => value.trim() ? void 0 : "AppSecret 不能为空"
+	});
+	const next = applyQQBotAccountConfig(params.cfg, params.accountId, {
+		appId: appId.trim(),
+		clientSecret: appSecret.trim()
+	});
+	await params.prompter.note("✔ QQ Bot 配置完成！", "QQ Bot");
+	return next;
+}
+async function finalizeQQBotSetup(params) {
+	const accountId = params.accountId.trim() || DEFAULT_ACCOUNT_ID;
+	let next = params.cfg;
+	const configured = isQQBotAccountConfigured(next, accountId);
+	const mode = await params.prompter.select({
+		message: configured ? "QQ 已绑定，选择操作" : "选择 QQ 绑定方式",
+		options: [
+			{
+				value: "qr",
+				label: "扫码绑定（推荐）",
+				hint: "使用 QQ 扫描二维码自动完成绑定"
+			},
+			{
+				value: "manual",
+				label: "手动输入 QQ Bot AppID 和 AppSecret",
+				hint: "需到 QQ 开放平台 q.qq.com 查看"
+			},
+			{
+				value: "skip",
+				label: configured ? "保持当前配置" : "稍后配置"
+			}
+		]
+	});
+	if (mode === "qr") next = await linkViaQrCode({
+		cfg: next,
+		accountId,
+		prompter: params.prompter,
+		runtime: params.runtime
+	});
+	else if (mode === "manual") next = await linkViaManualInput({
+		cfg: next,
+		accountId,
+		prompter: params.prompter
+	});
+	else if (!configured) await params.prompter.note(["您可以稍后运行以下命令重新选择 QQ Bot 进行配置：", "  openclaw channels add"].join("\n"), "QQ Bot");
+	return { cfg: next };
+}
+//#endregion
+//#region extensions/qqbot/src/bridge/setup/surface.ts
+const channel = "qqbot";
+const qqbotSetupWizard = {
+	channel,
+	status: createStandardChannelSetupStatus({
+		channelLabel: "QQ Bot",
+		configuredLabel: "configured",
+		unconfiguredLabel: "needs AppID + AppSercet",
+		configuredHint: "configured",
+		unconfiguredHint: "needs AppID + AppSercet",
+		configuredScore: 1,
+		unconfiguredScore: 6,
+		resolveConfigured: ({ cfg, accountId }) => (accountId ? [accountId] : listQQBotAccountIds(cfg)).some((resolvedAccountId) => {
+			return isAccountConfigured(resolveQQBotAccount(cfg, resolvedAccountId, { allowUnresolvedSecretRef: true }));
+		})
+	}),
+	credentials: [],
+	finalize: async ({ cfg, accountId, forceAllowFrom, prompter, runtime }) => await finalizeQQBotSetup({
+		cfg,
+		accountId,
+		forceAllowFrom,
+		prompter,
+		runtime
+	}),
+	disable: (cfg) => setSetupChannelEnabled(cfg, channel, false)
+};
+//#endregion
+//#region extensions/qqbot/src/config-schema.ts
+const AudioFormatPolicySchema = z.object({
+	sttDirectFormats: z.array(z.string()).optional(),
+	uploadDirectFormats: z.array(z.string()).optional(),
+	transcodeEnabled: z.boolean().optional()
+}).optional();
+const QQBotSttSchema = z.object({
+	enabled: z.boolean().optional(),
+	provider: z.string().optional(),
+	baseUrl: z.string().optional(),
+	apiKey: z.string().optional(),
+	model: z.string().optional()
+}).strict().optional();
+/** When `true`, same as `mode: "partial"` and `c2cStreamApi: true` for C2C. Object form kept for legacy configs. */
+const QQBotStreamingSchema = z.union([z.boolean(), z.object({
+	/** "partial" (default) enables block streaming; "off" disables it. */
+	mode: z.enum(["off", "partial"]).default("partial"),
+	/** @deprecated Prefer `streaming: true`. */
+	c2cStreamApi: z.boolean().optional()
+}).passthrough()]).optional();
+const QQBotExecApprovalsSchema = z.object({
+	enabled: z.union([z.boolean(), z.literal("auto")]).optional(),
+	approvers: z.array(z.string()).optional(),
+	agentFilter: z.array(z.string()).optional(),
+	sessionFilter: z.array(z.string()).optional(),
+	target: z.enum([
+		"dm",
+		"channel",
+		"both"
+	]).optional()
+}).strict().optional();
+const QQBotDmPolicySchema = z.enum([
+	"open",
+	"allowlist",
+	"disabled"
+]).optional();
+const QQBotGroupPolicySchema = z.enum([
+	"open",
+	"allowlist",
+	"disabled"
+]).optional();
+const QQBotAccountSchema = z.object({
+	enabled: z.boolean().optional(),
+	name: z.string().optional(),
+	appId: z.string().optional(),
+	clientSecret: buildSecretInputSchema().optional(),
+	clientSecretFile: z.string().optional(),
+	allowFrom: AllowFromListSchema,
+	groupAllowFrom: AllowFromListSchema,
+	dmPolicy: QQBotDmPolicySchema,
+	groupPolicy: QQBotGroupPolicySchema,
+	systemPrompt: z.string().optional(),
+	markdownSupport: z.boolean().optional(),
+	voiceDirectUploadFormats: z.array(z.string()).optional(),
+	audioFormatPolicy: AudioFormatPolicySchema,
+	urlDirectUpload: z.boolean().optional(),
+	upgradeUrl: z.string().optional(),
+	upgradeMode: z.enum(["doc", "hot-reload"]).optional(),
+	streaming: QQBotStreamingSchema,
+	execApprovals: QQBotExecApprovalsSchema
+}).passthrough();
+const qqbotChannelConfigSchema = buildChannelConfigSchema(QQBotAccountSchema.extend({
+	stt: QQBotSttSchema,
+	accounts: z.object({}).catchall(QQBotAccountSchema.passthrough()).optional(),
+	defaultAccount: z.string().optional()
+}).passthrough());
+//#endregion
+export { qqbotSetupAdapterShared as a, listQQBotAccountIds as c, DEFAULT_ACCOUNT_ID$2 as d, resolveAccountBase as f, setBridgeLogger as h, qqbotMeta as i, resolveDefaultQQBotAccountId as l, getBridgeLogger as m, qqbotSetupWizard as n, DEFAULT_ACCOUNT_ID$1 as o, ensurePlatformAdapter as p, qqbotConfigAdapter as r, applyQQBotAccountConfig as s, qqbotChannelConfigSchema as t, resolveQQBotAccount as u };

package/dist/{gateway-DEJhmN-p.js → gateway-Bz_nu9BP.js}

@@ -1,12 +1,9 @@
-import { E as setOutboundAudioPort, _ as sendVoice, c as isMediaPayload, g as sendVideoMsg, h as sendPhoto, l as parseQQBotPayload, m as sendDocument, o as encodePayloadForCron, r as sendMedia, s as isCronReminderPayload, u as normalizeMediaTags, v as resolveUserFacingMediaError, w as DEFAULT_MEDIA_SEND_ERROR } from "./outbound-BdQEr78b.js";
+import { E as setOutboundAudioPort, _ as sendVoice, c as isMediaPayload, g as sendVideoMsg, h as sendPhoto, l as parseQQBotPayload, m as sendDocument, o as encodePayloadForCron, r as sendMedia, s as isCronReminderPayload, u as normalizeMediaTags, v as resolveUserFacingMediaError, w as DEFAULT_MEDIA_SEND_ERROR } from "./outbound-DTQUASKu.js";
 import { c as getPlatformAdapter, i as normalizeOptionalString, n as normalizeLowercaseStringOrEmpty, o as readStringField, s as sanitizeFileName, t as asOptionalObjectRecord } from "./string-normalize-C46CS-F1.js";
-import { d as resolveAccountBase, f as ensurePlatformAdapter, m as setBridgeLogger } from "./config-DiBiPtf4.js";
-import { l as parseApprovalButtonData, t as authorizeQQBotApprovalAction } from "./exec-approvals-Deww_EGt.js";
-import { t as toGatewayAccount } from "./narrowing-Bj4eMufj.js";
-import { B as StreamInputState, C as debugWarn, D as openLocalFile, I as formatDuration, L as formatErrorMessage, N as getImageMimeType, P as getMaxUploadSize, R as StreamContentType, S as debugLog, T as getNextMsgSeq, a as createRawInputNotifyFn, b as withTokenRetry, c as getMessageApi, d as initSender, f as onMessageSent, g as sendText, h as sendMedia$1, i as clearTokenCache, j as formatFileSize, k as downloadFile, 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, v as startBackgroundTokenRefresh, x as debugError, y as stopBackgroundTokenRefresh, z as StreamInputMode } from "./sender-BeE_CBbN.js";
-import { n as getQQBotRuntimeForEngine, t as getQQBotRuntime } from "./runtime-B-cqLImu.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$1, s as getQQBotDataPath, u as getTempDir } from "./target-parser-ByU3srDK.js";
-import { a as getPluginVersion, i as getFrameworkVersion, n as runWithRequestContext, o as initCommands, s as matchSlashCommand } from "./request-context-Betw4nJr.js";
+import { f as resolveAccountBase, h as setBridgeLogger, p as ensurePlatformAdapter } from "./config-schema-BE5YP0NG.js";
+import { C as parseApprovalButtonData, a as getQQBotDataDir, d as isWindows, f as normalizePath$1, h as authorizeQQBotApprovalAction, i as getHomeDir, l as getTempDir, m as toGatewayAccount, o as getQQBotDataPath, p as resolveQQBotPayloadLocalFilePath, r as checkSilkWasmAvailable, s as getQQBotMediaDir, u as isLocalPath } from "./channel-nG7HntSR.js";
+import { B as StreamContentType, C as debugError, D as getNextMsgSeq, F as getImageMimeType, H as StreamInputState, I as getMaxUploadSize, N as formatFileSize, R as formatDuration, S as withTokenRetry, T as debugWarn, V as StreamInputMode, _ as sendInputNotify, a as acknowledgeInteraction, b as startBackgroundTokenRefresh, c as createRawInputNotifyFn, d as getMessageApi, f as getPluginUserAgent, g as registerAccount, h as onMessageSent, i as accountToCreds, j as downloadFile, k as openLocalFile, l as getAccessToken, m as initSender, n as getQQBotRuntimeForEngine, o as buildDeliveryTarget, p as initApiConfig, s as clearTokenCache, t as getQQBotRuntime, u as getGatewayUrl, v as sendMedia$1, w as debugLog, x as stopBackgroundTokenRefresh, y as sendText, z as formatErrorMessage } from "./runtime-BFcYWYuk.js";
+import { a as getPluginVersion, i as getFrameworkVersion, n as runWithRequestContext, o as initCommands, s as matchSlashCommand } from "./request-context-DiWgzdpn.js";
 import * as fs$1 from "node:fs";
 import fs from "node:fs";
 import * as os$1 from "node:os";

package/dist/{handler-runtime-COWL4RMq.js → handler-runtime-DMMHU4NC.js}

@@ -1,6 +1,6 @@
-import { a as resolveQQBotAccount, f as ensurePlatformAdapter, p as getBridgeLogger } from "./config-DiBiPtf4.js";
-import { a as shouldHandleQQBotExecApprovalRequest, c as buildPluginApprovalText, i as resolveQQBotExecApprovalConfig, n as isQQBotExecApprovalClientEnabled, o as buildApprovalKeyboard, r as matchesQQBotApprovalAccount, s as buildExecApprovalText, u as resolveApprovalTarget } from "./exec-approvals-Deww_EGt.js";
-import { c as getMessageApi, t as accountToCreds } from "./sender-BeE_CBbN.js";
+import { m as getBridgeLogger, p as ensurePlatformAdapter, u as resolveQQBotAccount } from "./config-schema-BE5YP0NG.js";
+import { S as buildPluginApprovalText, _ as matchesQQBotApprovalAccount, b as buildApprovalKeyboard, g as isQQBotExecApprovalClientEnabled, v as resolveQQBotExecApprovalConfig, w as resolveApprovalTarget, x as buildExecApprovalText, y as shouldHandleQQBotExecApprovalRequest } from "./channel-nG7HntSR.js";
+import { d as getMessageApi, i as accountToCreds } from "./runtime-BFcYWYuk.js";
 import { resolveApprovalRequestSessionConversation } from "openclaw/plugin-sdk/approval-native-runtime";
 import { createChannelApprovalNativeRuntimeAdapter } from "openclaw/plugin-sdk/approval-handler-runtime";
 //#region extensions/qqbot/src/bridge/approval/handler-runtime.ts

package/dist/{outbound-BdQEr78b.js → outbound-DTQUASKu.js}

@@ -1,6 +1,6 @@
 import { i as normalizeOptionalString, n as normalizeLowercaseStringOrEmpty, s as sanitizeFileName } from "./string-normalize-C46CS-F1.js";
-import { A as fileExistsAsync, C as debugWarn, E as UPLOAD_PREPARE_FALLBACK_CODE, F as readFileAsync, L as formatErrorMessage, M as getFileTypeName, N as getImageMimeType, O as checkFileSize, P as getMaxUploadSize, S as debugLog, g as sendText$1, h as sendMedia$1, j as formatFileSize, k as downloadFile, t as accountToCreds, u as initApiConfig, w as UploadDailyLimitExceededError, x as debugError } from "./sender-BeE_CBbN.js";
-import { c as getQQBotMediaDir, d as isLocalPath, m as resolveQQBotPayloadLocalFilePath, o as getQQBotDataDir, p as normalizePath, r as parseTarget$1 } from "./target-parser-ByU3srDK.js";
+import { a as getQQBotDataDir, f as normalizePath, n as parseTarget$1, p as resolveQQBotPayloadLocalFilePath, s as getQQBotMediaDir, u as isLocalPath } from "./channel-nG7HntSR.js";
+import { A as checkFileSize, C as debugError, E as UploadDailyLimitExceededError, F as getImageMimeType, I as getMaxUploadSize, L as readFileAsync, M as fileExistsAsync, N as formatFileSize, O as UPLOAD_PREPARE_FALLBACK_CODE, P as getFileTypeName, T as debugWarn, i as accountToCreds, j as downloadFile, p as initApiConfig, v as sendMedia$1, w as debugLog, y as sendText$1, z as formatErrorMessage } from "./runtime-BFcYWYuk.js";
 import { pathExistsSync, resolveLocalPathFromRootsSync } from "openclaw/plugin-sdk/security-runtime";
 import path from "node:path";
 import { getFileExtension } from "openclaw/plugin-sdk/media-mime";

package/dist/{request-context-Betw4nJr.js → request-context-DiWgzdpn.js}

@@ -1,5 +1,5 @@
-import { S as debugLog } from "./sender-BeE_CBbN.js";
-import { a as getHomeDir, f as isWindows, l as getQQBotMediaPath, o as getQQBotDataDir } from "./target-parser-ByU3srDK.js";
+import { a as getQQBotDataDir, c as getQQBotMediaPath, d as isWindows, i as getHomeDir } from "./channel-nG7HntSR.js";
+import { w as debugLog } from "./runtime-BFcYWYuk.js";
 import fs from "node:fs";
 import path from "node:path";
 import { loadJsonFile } from "openclaw/plugin-sdk/json-store";

package/dist/{sender-BeE_CBbN.js → runtime-BFcYWYuk.js}

@@ -1,5 +1,6 @@
 import { c as getPlatformAdapter, i as normalizeOptionalString, s as sanitizeFileName } from "./string-normalize-C46CS-F1.js";
 import * as fs$1 from "node:fs";
+import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import os from "node:os";
 import * as crypto$1 from "node:crypto";
 import crypto from "node:crypto";
@@ -1962,4 +1963,19 @@ function supportsRichMedia(targetType) {
 	return targetType === "c2c" || targetType === "group";
 }
 //#endregion
-export { fileExistsAsync as A, StreamInputState as B, debugWarn as C, openLocalFile as D, UPLOAD_PREPARE_FALLBACK_CODE as E, readFileAsync as F, formatDuration as I, formatErrorMessage as L, getFileTypeName as M, getImageMimeType as N, checkFileSize as O, getMaxUploadSize as P, StreamContentType as R, debugLog as S, getNextMsgSeq as T, setOpenClawVersion as _, createRawInputNotifyFn as a, withTokenRetry as b, getMessageApi as c, initSender as d, onMessageSent as f, sendText as g, sendMedia as h, clearTokenCache as i, formatFileSize as j, downloadFile as k, getPluginUserAgent as l, sendInputNotify as m, acknowledgeInteraction as n, getAccessToken as o, registerAccount as p, buildDeliveryTarget as r, getGatewayUrl as s, accountToCreds as t, initApiConfig as u, startBackgroundTokenRefresh as v, UploadDailyLimitExceededError as w, debugError as x, stopBackgroundTokenRefresh as y, StreamInputMode as z };
+//#region extensions/qqbot/src/bridge/runtime.ts
+const { setRuntime: _setRuntime, getRuntime: getQQBotRuntime } = createPluginRuntimeStore({
+	pluginId: "qqbot",
+	errorMessage: "QQBot runtime not initialized"
+});
+/** Set the QQBot runtime and inject the framework version into the User-Agent. */
+function setQQBotRuntime(runtime) {
+	_setRuntime(runtime);
+	setOpenClawVersion(runtime.version);
+}
+/** Type-narrowed getter for engine/ modules that need GatewayPluginRuntime. */
+function getQQBotRuntimeForEngine() {
+	return getQQBotRuntime();
+}
+//#endregion
+export { checkFileSize as A, StreamContentType as B, debugError as C, getNextMsgSeq as D, UploadDailyLimitExceededError as E, getImageMimeType as F, StreamInputState as H, getMaxUploadSize as I, readFileAsync as L, fileExistsAsync as M, formatFileSize as N, UPLOAD_PREPARE_FALLBACK_CODE as O, getFileTypeName as P, formatDuration as R, withTokenRetry as S, debugWarn as T, StreamInputMode as V, sendInputNotify as _, acknowledgeInteraction as a, startBackgroundTokenRefresh as b, createRawInputNotifyFn as c, getMessageApi as d, getPluginUserAgent as f, registerAccount as g, onMessageSent as h, accountToCreds as i, downloadFile as j, openLocalFile as k, getAccessToken as l, initSender as m, getQQBotRuntimeForEngine as n, buildDeliveryTarget as o, initApiConfig as p, setQQBotRuntime as r, clearTokenCache as s, getQQBotRuntime as t, getGatewayUrl as u, sendMedia as v, debugLog as w, stopBackgroundTokenRefresh as x, sendText as y, formatErrorMessage as z };

package/dist/runtime-api.js

@@ -1,2 +1,2 @@
-import { r as setQQBotRuntime, t as getQQBotRuntime } from "./runtime-B-cqLImu.js";
+import { r as setQQBotRuntime, t as getQQBotRuntime } from "./runtime-BFcYWYuk.js";
 export { getQQBotRuntime, setQQBotRuntime };

package/dist/setup-plugin-api.js

@@ -1,2 +1,2 @@
-import { t as qqbotSetupPlugin } from "./channel.setup-DWWV_GAa.js";
+import { t as qqbotSetupPlugin } from "./channel.setup-D_8Ryfln.js";
 export { qqbotSetupPlugin };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/qqbot",
-  "version": "2026.5.14-beta.1",
+  "version": "2026.5.14-beta.2",
   "private": false,
   "description": "OpenClaw QQ Bot channel plugin",
   "repository": {
@@ -12,7 +12,7 @@
     "@tencent-connect/qqbot-connector": "1.1.0",
     "mpg123-decoder": "1.0.3",
     "silk-wasm": "3.7.1",
-    "ws": "8.20.0",
+    "ws": "8.20.1",
     "zod": "4.4.3"
   },
   "devDependencies": {
@@ -21,7 +21,7 @@
     "openclaw": "workspace:*"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.5.14-beta.1"
+    "openclaw": ">=2026.5.14-beta.2"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -50,10 +50,10 @@
       "minHostVersion": ">=2026.4.10"
     },
     "compat": {
-      "pluginApi": ">=2026.5.14-beta.1"
+      "pluginApi": ">=2026.5.14-beta.2"
     },
     "build": {
-      "openclawVersion": "2026.5.14-beta.1"
+      "openclawVersion": "2026.5.14-beta.2"
     },
     "release": {
       "publishToClawHub": true,