@jerryliang122/openclaw-qqbot 1.0.4 → 1.0.6

package/dist/index.cjs

@@ -34,367 +34,79 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/config.ts
-var config_exports = {};
-__export(config_exports, {
-  DEFAULT_ACCOUNT_ID: () => DEFAULT_ACCOUNT_ID,
-  applyQQBotAccountConfig: () => applyQQBotAccountConfig,
-  isGroupAllowed: () => isGroupAllowed,
-  listQQBotAccountIds: () => listQQBotAccountIds,
-  resolveDefaultQQBotAccountId: () => resolveDefaultQQBotAccountId,
-  resolveGroupAllowFrom: () => resolveGroupAllowFrom,
-  resolveGroupCoalesceConfig: () => resolveGroupCoalesceConfig,
-  resolveGroupCoalesceEnabled: () => resolveGroupCoalesceEnabled,
-  resolveGroupConfig: () => resolveGroupConfig,
-  resolveGroupConfigFromAccount: () => resolveGroupConfigFromAccount,
-  resolveGroupName: () => resolveGroupName,
-  resolveGroupPolicy: () => resolveGroupPolicy,
-  resolveGroupPrompt: () => resolveGroupPrompt,
-  resolveHistoryLimit: () => resolveHistoryLimit,
-  resolveIgnoreOtherMentions: () => resolveIgnoreOtherMentions,
-  resolveMentionPatterns: () => resolveMentionPatterns,
-  resolveQQBotAccount: () => resolveQQBotAccount,
-  resolveQQBotEnvAppId: () => resolveQQBotEnvAppId,
-  resolveQQBotEnvClientSecret: () => resolveQQBotEnvClientSecret,
-  resolveRequireMention: () => resolveRequireMention,
-  resolveToolPolicy: () => resolveToolPolicy,
-  resolveUserAgentSuffix: () => resolveUserAgentSuffix
-});
-function resolveMentionPatterns(cfg, agentId) {
-  if (agentId) {
-    const agents = cfg.agents;
-    const entry = agents?.list?.find((a) => a.id?.trim().toLowerCase() === agentId.trim().toLowerCase());
-    const agentGroupChat = entry?.groupChat;
-    if (agentGroupChat && Object.hasOwn(agentGroupChat, "mentionPatterns")) {
-      return agentGroupChat.mentionPatterns ?? [];
-    }
-  }
-  const globalGroupChat = cfg?.messages?.groupChat;
-  if (globalGroupChat && typeof globalGroupChat === "object" && Object.hasOwn(globalGroupChat, "mentionPatterns")) {
-    return globalGroupChat.mentionPatterns ?? [];
+// src/utils/platform.ts
+function getHomeDir() {
+  try {
+    const home = os.homedir();
+    if (home && fs.existsSync(home)) return home;
+  } catch {
   }
-  return [];
+  const envHome = process.env.HOME || process.env.USERPROFILE;
+  if (envHome && fs.existsSync(envHome)) return envHome;
+  return os.tmpdir();
 }
-function evaluateMatchedGroupAccessForPolicy(params) {
-  if (params.groupPolicy === "disabled") {
-    return { allowed: false, groupPolicy: params.groupPolicy, reason: "disabled" };
-  }
-  if (params.groupPolicy === "allowlist") {
-    if (params.requireMatchInput && !params.hasMatchInput) {
-      return { allowed: false, groupPolicy: params.groupPolicy, reason: "missing_match_input" };
-    }
-    if (!params.allowlistConfigured) {
-      return { allowed: false, groupPolicy: params.groupPolicy, reason: "empty_allowlist" };
-    }
-    if (!params.allowlistMatched) {
-      return { allowed: false, groupPolicy: params.groupPolicy, reason: "not_allowlisted" };
-    }
+function getQQBotDataDir(...subPaths) {
+  const dir = path.join(getHomeDir(), ".openclaw", "qqbot", ...subPaths);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
   }
-  return { allowed: true, groupPolicy: params.groupPolicy, reason: "allowed" };
-}
-function resolveGroupPolicy(cfg, accountId) {
-  const account = resolveQQBotAccount(cfg, accountId);
-  return account.config?.groupPolicy ?? DEFAULT_GROUP_POLICY;
-}
-function resolveGroupAllowFrom(cfg, accountId) {
-  const account = resolveQQBotAccount(cfg, accountId);
-  return (account.config?.groupAllowFrom ?? []).map((id) => String(id).trim().toUpperCase());
-}
-function isGroupAllowed(cfg, groupOpenid, accountId) {
-  const account = resolveQQBotAccount(cfg, accountId);
-  const policy = account.config?.groupPolicy ?? DEFAULT_GROUP_POLICY;
-  const allowList = (account.config?.groupAllowFrom ?? []).map((id) => String(id).trim().toUpperCase());
-  const allowlistConfigured = allowList.length > 0;
-  const allowlistMatched = allowList.some((id) => id === "*" || id === groupOpenid.toUpperCase());
-  return evaluateMatchedGroupAccessForPolicy({
-    groupPolicy: policy,
-    allowlistConfigured,
-    allowlistMatched
-  }).allowed;
-}
-function resolveGroupConfigFromAccount(account, groupOpenid) {
-  const groups = account.config?.groups ?? {};
-  const wildcardCfg = groups["*"] ?? {};
-  const specificCfg = groups[groupOpenid] ?? {};
-  const accountDefaultRequireMention = account.config?.defaultRequireMention ?? DEFAULT_GROUP_CONFIG.requireMention;
-  const accountDefaultCoalesce = account.config?.groupCoalesce ?? DEFAULT_GROUP_COALESCE_CONFIG;
-  const coalesce = {
-    enabled: specificCfg.coalesce?.enabled ?? wildcardCfg.coalesce?.enabled ?? accountDefaultCoalesce.enabled ?? DEFAULT_GROUP_COALESCE_CONFIG.enabled
-  };
-  return {
-    requireMention: specificCfg.requireMention ?? wildcardCfg.requireMention ?? accountDefaultRequireMention,
-    ignoreOtherMentions: specificCfg.ignoreOtherMentions ?? wildcardCfg.ignoreOtherMentions ?? DEFAULT_GROUP_CONFIG.ignoreOtherMentions,
-    toolPolicy: specificCfg.toolPolicy ?? wildcardCfg.toolPolicy ?? DEFAULT_GROUP_CONFIG.toolPolicy,
-    name: specificCfg.name ?? wildcardCfg.name ?? DEFAULT_GROUP_CONFIG.name,
-    prompt: specificCfg.prompt ?? wildcardCfg.prompt ?? DEFAULT_GROUP_PROMPT,
-    historyLimit: specificCfg.historyLimit ?? wildcardCfg.historyLimit ?? DEFAULT_GROUP_CONFIG.historyLimit,
-    historyMode: specificCfg.historyMode ?? wildcardCfg.historyMode ?? DEFAULT_GROUP_CONFIG.historyMode,
-    unmentionedInbound: specificCfg.unmentionedInbound ?? wildcardCfg.unmentionedInbound ?? DEFAULT_GROUP_CONFIG.unmentionedInbound,
-    coalesce
-  };
-}
-function resolveGroupConfig(cfg, groupOpenid, accountId) {
-  return resolveGroupConfigFromAccount(resolveQQBotAccount(cfg, accountId), groupOpenid);
-}
-function resolveHistoryLimit(cfg, groupOpenid, accountId) {
-  return Math.max(0, resolveGroupConfig(cfg, groupOpenid, accountId).historyLimit);
-}
-function resolveGroupPrompt(cfg, groupOpenid, accountId) {
-  return resolveGroupConfig(cfg, groupOpenid, accountId).prompt;
-}
-function resolveRequireMention(cfg, groupOpenid, accountId) {
-  return resolveGroupConfig(cfg, groupOpenid, accountId).requireMention;
-}
-function resolveIgnoreOtherMentions(cfg, groupOpenid, accountId) {
-  return resolveGroupConfig(cfg, groupOpenid, accountId).ignoreOtherMentions;
-}
-function resolveToolPolicy(cfg, groupOpenid, accountId) {
-  return resolveGroupConfig(cfg, groupOpenid, accountId).toolPolicy;
-}
-function resolveGroupName(cfg, groupOpenid, accountId) {
-  const name = resolveGroupConfig(cfg, groupOpenid, accountId).name;
-  return name || groupOpenid.slice(0, 8);
-}
-function resolveUserAgentSuffix(cfg) {
-  const qqbot = cfg.channels?.qqbot;
-  return qqbot?.userAgentSuffix ? String(qqbot.userAgentSuffix).trim() : "";
+  return dir;
 }
-function normalizeAppId(raw) {
-  if (raw === null || raw === void 0) return "";
-  return String(raw).trim();
+function getQQBotMediaDir(...subPaths) {
+  const dir = path.join(getHomeDir(), ".openclaw", "media", "qqbot", ...subPaths);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  return dir;
 }
-function firstNonEmptyEnv(...values) {
-  for (const value of values) {
-    if (value?.trim()) return value.trim();
+var os, path, fs;
+var init_platform = __esm({
+  "src/utils/platform.ts"() {
+    "use strict";
+    os = __toESM(require("os"), 1);
+    path = __toESM(require("path"), 1);
+    fs = __toESM(require("fs"), 1);
   }
-  return "";
+});
+
+// src/request-context.ts
+function runWithRequestContext(ctx, fn) {
+  return asyncLocalStorage.run(ctx, fn);
 }
-function resolveQQBotEnvAppId() {
-  return firstNonEmptyEnv(process.env.QQBOT_APPID);
+function getRequestContext() {
+  return asyncLocalStorage.getStore();
 }
-function resolveQQBotEnvClientSecret() {
-  return firstNonEmptyEnv(process.env.QQBOT_SECRET);
+function getRequestTarget() {
+  return asyncLocalStorage.getStore()?.target;
 }
-function listQQBotAccountIds(cfg) {
-  const ids = /* @__PURE__ */ new Set();
-  const qqbot = cfg.channels?.qqbot;
-  if (qqbot?.appId || resolveQQBotEnvAppId()) {
-    ids.add(DEFAULT_ACCOUNT_ID);
-  }
-  if (qqbot?.accounts) {
-    for (const accountId of Object.keys(qqbot.accounts)) {
-      if (qqbot.accounts[accountId]?.appId) {
-        ids.add(accountId);
-      }
-    }
-  }
-  return Array.from(ids);
+function getRequestAccountId() {
+  return asyncLocalStorage.getStore()?.accountId;
 }
-function resolveDefaultQQBotAccountId(cfg) {
-  const qqbot = cfg.channels?.qqbot;
-  if (qqbot?.appId || resolveQQBotEnvAppId()) {
-    return DEFAULT_ACCOUNT_ID;
-  }
-  if (qqbot?.accounts) {
-    const ids = Object.keys(qqbot.accounts);
-    if (ids.length > 0) {
-      return ids[0];
-    }
+var import_node_async_hooks, asyncLocalStorage;
+var init_request_context = __esm({
+  "src/request-context.ts"() {
+    "use strict";
+    import_node_async_hooks = require("async_hooks");
+    asyncLocalStorage = new import_node_async_hooks.AsyncLocalStorage();
   }
-  return DEFAULT_ACCOUNT_ID;
-}
-function resolveQQBotAccount(cfg, accountId) {
-  const resolvedAccountId = accountId ?? resolveDefaultQQBotAccountId(cfg);
-  const qqbot = cfg.channels?.qqbot;
-  let accountConfig = {};
-  let appId = "";
-  let clientSecret = "";
-  let secretSource = "none";
-  if (resolvedAccountId === DEFAULT_ACCOUNT_ID) {
-    const { accounts: _accounts, ...topLevelConfig } = qqbot ?? {};
-    accountConfig = {
-      ...topLevelConfig,
-      markdownSupport: qqbot?.markdownSupport ?? true
-    };
-    appId = normalizeAppId(qqbot?.appId);
-  } else {
-    const account = qqbot?.accounts?.[resolvedAccountId];
-    accountConfig = account ?? {};
-    appId = normalizeAppId(account?.appId);
+});
+
+// node_modules/@tencent-connect/qqbot-nodejs/dist/middleware/types.js
+function resolvePolicy(ctx, path21, explicit, defaultValue) {
+  if (explicit !== void 0 && explicit !== null) {
+    return explicit;
   }
-  if (accountConfig.clientSecret) {
-    clientSecret = accountConfig.clientSecret;
-    secretSource = "config";
-  } else if (accountConfig.clientSecretFile) {
-    secretSource = "file";
-  } else if (resolvedAccountId === DEFAULT_ACCOUNT_ID && resolveQQBotEnvClientSecret()) {
-    clientSecret = resolveQQBotEnvClientSecret();
-    secretSource = "env";
+  const keys = path21.split(".");
+  let value = ctx.state.policy;
+  for (const key2 of keys) {
+    if (value === null || value === void 0)
+      break;
+    value = value[key2];
   }
-  if (!appId && resolvedAccountId === DEFAULT_ACCOUNT_ID) {
-    appId = normalizeAppId(resolveQQBotEnvAppId());
+  if (value !== void 0 && value !== null) {
+    return value;
   }
-  return {
-    accountId: resolvedAccountId,
-    name: accountConfig.name,
-    enabled: accountConfig.enabled !== false,
-    appId,
-    clientSecret,
-    secretSource,
-    systemPrompt: accountConfig.systemPrompt,
-    markdownSupport: accountConfig.markdownSupport !== false,
-    commandPanelNative: accountConfig.commands?.native !== false,
-    userAgentSuffix: resolveUserAgentSuffix(cfg),
-    config: accountConfig
-  };
-}
-function applyQQBotAccountConfig(cfg, accountId, input) {
-  const next = { ...cfg };
-  if (accountId === DEFAULT_ACCOUNT_ID) {
-    const existingConfig = next.channels?.qqbot || {};
-    const allowFrom = existingConfig.allowFrom ?? ["*"];
-    next.channels = {
-      ...next.channels,
-      qqbot: {
-        ...next.channels?.qqbot || {},
-        enabled: true,
-        allowFrom,
-        ...input.appId ? { appId: input.appId } : {},
-        ...input.clientSecret ? { clientSecret: input.clientSecret } : input.clientSecretFile ? { clientSecretFile: input.clientSecretFile } : {},
-        ...input.name ? { name: input.name } : {}
-      }
-    };
-  } else {
-    const existingAccountConfig = next.channels?.qqbot?.accounts?.[accountId] || {};
-    const allowFrom = existingAccountConfig.allowFrom ?? ["*"];
-    next.channels = {
-      ...next.channels,
-      qqbot: {
-        ...next.channels?.qqbot || {},
-        enabled: true,
-        accounts: {
-          ...next.channels?.qqbot?.accounts || {},
-          [accountId]: {
-            ...next.channels?.qqbot?.accounts?.[accountId] || {},
-            enabled: true,
-            allowFrom,
-            ...input.appId ? { appId: input.appId } : {},
-            ...input.clientSecret ? { clientSecret: input.clientSecret } : input.clientSecretFile ? { clientSecretFile: input.clientSecretFile } : {},
-            ...input.name ? { name: input.name } : {}
-          }
-        }
-      }
-    };
-  }
-  return next;
-}
-function resolveGroupCoalesceConfig(cfg, groupOpenid, accountId) {
-  return resolveGroupConfig(cfg, groupOpenid, accountId).coalesce;
-}
-function resolveGroupCoalesceEnabled(cfg, groupOpenid, accountId) {
-  return resolveGroupCoalesceConfig(cfg, groupOpenid, accountId).enabled;
-}
-var DEFAULT_ACCOUNT_ID, DEFAULT_GROUP_POLICY, DEFAULT_GROUP_HISTORY_LIMIT, DEFAULT_GROUP_COALESCE_CONFIG, DEFAULT_GROUP_CONFIG, DEFAULT_GROUP_PROMPT;
-var init_config = __esm({
-  "src/config.ts"() {
-    "use strict";
-    DEFAULT_ACCOUNT_ID = "default";
-    DEFAULT_GROUP_POLICY = "open";
-    DEFAULT_GROUP_HISTORY_LIMIT = 20;
-    DEFAULT_GROUP_COALESCE_CONFIG = {
-      enabled: true
-    };
-    DEFAULT_GROUP_CONFIG = {
-      requireMention: true,
-      ignoreOtherMentions: false,
-      toolPolicy: "restricted",
-      name: "",
-      historyLimit: DEFAULT_GROUP_HISTORY_LIMIT,
-      historyMode: "clear",
-      unmentionedInbound: "user_request",
-      coalesce: DEFAULT_GROUP_COALESCE_CONFIG
-    };
-    DEFAULT_GROUP_PROMPT = [
-      "\u82E5\u53D1\u9001\u8005\u4E3A\u673A\u5668\u4EBA\uFF0C\u4EC5\u5728\u5BF9\u65B9\u660E\u786E@\u4F60\u63D0\u95EE\u6216\u8BF7\u6C42\u534F\u52A9\u5177\u4F53\u4EFB\u52A1\u65F6\uFF0C\u4EE5\u7B80\u6D01\u660E\u4E86\u7684\u5185\u5BB9\u56DE\u590D\uFF0C",
-      "\u907F\u514D\u4E0E\u5176\u4ED6\u673A\u5668\u4EBA\u4EA7\u751F\u62A2\u7B54\u6216\u591A\u8F6E\u65E0\u610F\u4E49\u5BF9\u8BDD\u3002",
-      "\u5728\u7FA4\u804A\u4E2D\u4F18\u5148\u8BA9\u4EBA\u7C7B\u7528\u6237\u7684\u6D88\u606F\u5F97\u5230\u54CD\u5E94\uFF0C\u673A\u5668\u4EBA\u4E4B\u95F4\u4FDD\u6301\u534F\u4F5C\u800C\u975E\u7ADE\u4E89\uFF0C\u786E\u4FDD\u5BF9\u8BDD\u6709\u5E8F\u4E0D\u5237\u5C4F\u3002"
-    ].join("");
-  }
-});
-
-// src/utils/platform.ts
-function getHomeDir() {
-  try {
-    const home = os.homedir();
-    if (home && fs.existsSync(home)) return home;
-  } catch {
-  }
-  const envHome = process.env.HOME || process.env.USERPROFILE;
-  if (envHome && fs.existsSync(envHome)) return envHome;
-  return os.tmpdir();
-}
-function getQQBotDataDir(...subPaths) {
-  const dir = path.join(getHomeDir(), ".openclaw", "qqbot", ...subPaths);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  return dir;
-}
-function getQQBotMediaDir(...subPaths) {
-  const dir = path.join(getHomeDir(), ".openclaw", "media", "qqbot", ...subPaths);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  return dir;
-}
-var os, path, fs;
-var init_platform = __esm({
-  "src/utils/platform.ts"() {
-    "use strict";
-    os = __toESM(require("os"), 1);
-    path = __toESM(require("path"), 1);
-    fs = __toESM(require("fs"), 1);
-  }
-});
-
-// src/request-context.ts
-function runWithRequestContext(ctx, fn) {
-  return asyncLocalStorage.run(ctx, fn);
-}
-function getRequestContext() {
-  return asyncLocalStorage.getStore();
-}
-function getRequestTarget() {
-  return asyncLocalStorage.getStore()?.target;
-}
-function getRequestAccountId() {
-  return asyncLocalStorage.getStore()?.accountId;
-}
-var import_node_async_hooks, asyncLocalStorage;
-var init_request_context = __esm({
-  "src/request-context.ts"() {
-    "use strict";
-    import_node_async_hooks = require("async_hooks");
-    asyncLocalStorage = new import_node_async_hooks.AsyncLocalStorage();
-  }
-});
-
-// node_modules/@tencent-connect/qqbot-nodejs/dist/middleware/types.js
-function resolvePolicy(ctx, path21, explicit, defaultValue) {
-  if (explicit !== void 0 && explicit !== null) {
-    return explicit;
-  }
-  const keys = path21.split(".");
-  let value = ctx.state.policy;
-  for (const key2 of keys) {
-    if (value === null || value === void 0)
-      break;
-    value = value[key2];
-  }
-  if (value !== void 0 && value !== null) {
-    return value;
-  }
-  return defaultValue;
+  return defaultValue;
 }
 async function runMiddlewareChain(middlewares, ctx) {
   let index = -1;
@@ -8272,7 +7984,10 @@ var outbound_service_exports = {};
 __export(outbound_service_exports, {
   OutboundService: () => OutboundService,
   getGateway: () => getGateway,
+  getRegisteredAccountIds: () => getRegisteredAccountIds,
+  notRunningError: () => notRunningError,
   registerGateway: () => registerGateway,
+  resolveGatewayForSend: () => resolveGatewayForSend,
   rollbackPassiveSlot: () => rollbackPassiveSlot,
   sendMedia: () => sendMedia,
   sendText: () => sendText,
@@ -8281,6 +7996,13 @@ __export(outbound_service_exports, {
   tryAcquirePassiveSlot: () => tryAcquirePassiveSlot,
   unregisterGateway: () => unregisterGateway
 });
+function logFallbackInfo(msg) {
+  try {
+    svcLog ??= createPluginLogger({ prefix: "[outbound]" });
+    svcLog.info(msg);
+  } catch {
+  }
+}
 function reservePassiveReply(params) {
   if (!params.replyToId) return { rollback: () => {
   } };
@@ -8310,26 +8032,57 @@ function rollbackPassiveSlot(accountId, msgId) {
 function registerGateway(accountId, gw) {
   gateways.set(accountId, gw);
 }
-function unregisterGateway(accountId) {
+function unregisterGateway(accountId, expectGw) {
+  if (expectGw) {
+    if (gateways.get(accountId) !== expectGw) return;
+    gateways.delete(accountId);
+    clearQuotaCacheForAccount(accountId);
+    return;
+  }
   gateways.delete(accountId);
   clearQuotaCacheForAccount(accountId);
 }
 function getGateway(accountId) {
   return gateways.get(accountId);
 }
+function getRegisteredAccountIds() {
+  return [...gateways.keys()];
+}
+function resolveGatewayForSend(accountId) {
+  const gw = gateways.get(accountId);
+  if (gw) return { gw, accountId };
+  const running = getRegisteredAccountIds();
+  if (running.length === 1) {
+    const soleAccountId = running[0];
+    const soleGw = gateways.get(soleAccountId);
+    if (!soleGw) return void 0;
+    if (!gatewayFallbackLogged.has(accountId)) {
+      gatewayFallbackLogged.add(accountId);
+      logFallbackInfo(
+        `account "${accountId}" not running; falling back to sole running account "${soleAccountId}"`
+      );
+    }
+    return { gw: soleGw, accountId: soleAccountId, fallbackFrom: accountId };
+  }
+  return void 0;
+}
+function notRunningError(accountId) {
+  const running = getRegisteredAccountIds();
+  return `Bot "${accountId}" not running${running.length ? ` (running accounts: ${running.join(", ")})` : ""}`;
+}
 async function sendText(params) {
   const accountId = params.account.accountId;
-  const gw = gateways.get(accountId);
-  if (!gw) return { error: `Bot "${accountId}" not running` };
+  const resolved = resolveGatewayForSend(accountId);
+  if (!resolved) return { error: notRunningError(accountId) };
   const target = parseTarget(params.to);
   const reservation = reservePassiveReply({
     replyToId: params.replyToId,
-    accountId,
+    accountId: resolved.accountId,
     scope: target.scope,
     quotaReserved: params.quotaReserved
   });
   try {
-    const result = await gw.sendText(target, params.text, { msgId: reservation.msgId });
+    const result = await resolved.gw.sendText(target, params.text, { msgId: reservation.msgId });
     return { messageId: result.id };
   } catch (err) {
     reservation.rollback();
@@ -8338,12 +8091,12 @@ async function sendText(params) {
 }
 async function sendMedia(params) {
   const accountId = params.account.accountId;
-  const gw = gateways.get(accountId);
-  if (!gw) return { error: `Bot "${accountId}" not running` };
+  const resolved = resolveGatewayForSend(accountId);
+  if (!resolved) return { error: notRunningError(accountId) };
   const target = parseTarget(params.to);
   const reservation = reservePassiveReply({
     replyToId: params.replyToId,
-    accountId,
+    accountId: resolved.accountId,
     scope: target.scope,
     quotaReserved: params.quotaReserved
   });
@@ -8352,19 +8105,19 @@ async function sendMedia(params) {
     const msgId = reservation.msgId;
     if (kind === "voice") {
       const source = resolveVoiceSource(params.mediaUrl);
-      const result2 = await gw.sendVoice(target, source, { text: params.text, msgId });
+      const result2 = await resolved.gw.sendVoice(target, source, { text: params.text, msgId });
       return { messageId: result2.id };
     }
     if (kind === "video") {
-      const result2 = await gw.sendVideo(target, params.mediaUrl, { text: params.text, msgId });
+      const result2 = await resolved.gw.sendVideo(target, params.mediaUrl, { text: params.text, msgId });
       return { messageId: result2.id };
     }
     if (kind === "file") {
-      const result2 = await gw.sendFile(target, params.mediaUrl, { text: params.text, msgId });
+      const result2 = await resolved.gw.sendFile(target, params.mediaUrl, { text: params.text, msgId });
       return { messageId: result2.id };
     }
     const fileType = MEDIA_KIND_TO_FILE_TYPE[kind];
-    const result = await gw.sendMedia(target, params.mediaUrl, { text: params.text, msgId, fileType });
+    const result = await resolved.gw.sendMedia(target, params.mediaUrl, { text: params.text, msgId, fileType });
     return { messageId: result.id };
   } catch (err) {
     reservation.rollback();
@@ -8373,17 +8126,17 @@ async function sendMedia(params) {
 }
 async function sendVoice(params) {
   const accountId = params.account.accountId;
-  const gw = gateways.get(accountId);
-  if (!gw) return { error: `Bot "${accountId}" not running` };
+  const resolved = resolveGatewayForSend(accountId);
+  if (!resolved) return { error: notRunningError(accountId) };
   const target = parseTarget(params.to);
   const reservation = reservePassiveReply({
     replyToId: params.replyToId,
-    accountId,
+    accountId: resolved.accountId,
     scope: target.scope,
     quotaReserved: params.quotaReserved
   });
   try {
-    const result = await gw.sendVoice(target, params.source, { msgId: reservation.msgId });
+    const result = await resolved.gw.sendVoice(target, params.source, { msgId: reservation.msgId });
     return { messageId: result.id };
   } catch (err) {
     reservation.rollback();
@@ -8392,17 +8145,17 @@ async function sendVoice(params) {
 }
 async function sendVideo(params) {
   const accountId = params.account.accountId;
-  const gw = gateways.get(accountId);
-  if (!gw) return { error: `Bot "${accountId}" not running` };
+  const resolved = resolveGatewayForSend(accountId);
+  if (!resolved) return { error: notRunningError(accountId) };
   const target = parseTarget(params.to);
   const reservation = reservePassiveReply({
     replyToId: params.replyToId,
-    accountId,
+    accountId: resolved.accountId,
     scope: target.scope,
     quotaReserved: params.quotaReserved
   });
   try {
-    const result = await gw.sendVideo(target, params.videoUrl, { msgId: reservation.msgId });
+    const result = await resolved.gw.sendVideo(target, params.videoUrl, { msgId: reservation.msgId });
     return { messageId: result.id };
   } catch (err) {
     reservation.rollback();
@@ -8427,15 +8180,20 @@ function formatError(err) {
   }
   return { error: String(err) };
 }
-var path4, gateways, MEDIA_KIND_TO_FILE_TYPE, OutboundService;
+var path4, GATEWAYS_REGISTRY_KEY, globalRegistry, gateways, svcLog, gatewayFallbackLogged, MEDIA_KIND_TO_FILE_TYPE, OutboundService;
 var init_outbound_service = __esm({
   "src/outbound/outbound-service.ts"() {
     "use strict";
     path4 = __toESM(require("path"), 1);
     init_dist();
+    init_plugin_logger();
     init_target();
     init_quota_manager();
-    gateways = /* @__PURE__ */ new Map();
+    GATEWAYS_REGISTRY_KEY = /* @__PURE__ */ Symbol.for("openclaw-qqbot.gateways");
+    globalRegistry = globalThis;
+    gateways = globalRegistry[GATEWAYS_REGISTRY_KEY] ?? /* @__PURE__ */ new Map();
+    globalRegistry[GATEWAYS_REGISTRY_KEY] = gateways;
+    gatewayFallbackLogged = /* @__PURE__ */ new Set();
     MEDIA_KIND_TO_FILE_TYPE = {
       image: MediaFileType.IMAGE,
       voice: MediaFileType.VOICE,
@@ -8501,7 +8259,7 @@ var init_outbound_service = __esm({
 
 // src/utils/pkg-version.ts
 function getPackageVersion() {
-  return true ? "1.0.4" : "unknown";
+  return true ? "1.0.6" : "unknown";
 }
 function getOpenclawVersion(runtimeVersion) {
   return runtimeVersion && runtimeVersion !== "unknown" ? runtimeVersion : "unknown";
@@ -8768,90 +8526,464 @@ function installExitHooksOnce() {
     process.exit(0);
   });
 }
-function getQQBotRuntime() {
-  if (!runtime) throw new Error("QQBot runtime not initialized");
-  return runtime;
+function getQQBotRuntime() {
+  if (!runtime) throw new Error("QQBot runtime not initialized");
+  return runtime;
+}
+function tryGetQQBotRuntime() {
+  return runtime;
+}
+var runtime, exitHooksInstalled;
+var init_runtime = __esm({
+  "src/runtime.ts"() {
+    "use strict";
+    init_bot_instance();
+    init_ref_index_store();
+    init_pkg_version();
+    runtime = null;
+    exitHooksInstalled = false;
+  }
+});
+
+// src/utils/plugin-logger.ts
+function consoleSink() {
+  const C2 = "\x1B[36m", Y = "\x1B[33m", R = "\x1B[31m", G = "\x1B[90m", X = "\x1B[0m";
+  return {
+    debug: (m3) => console.debug(`${G}[qqbot]${X}`, m3),
+    info: (m3) => console.log(`${C2}[qqbot]${X}`, m3),
+    warn: (m3) => console.warn(`${Y}[qqbot]${X}`, m3),
+    error: (m3) => console.error(`${R}[qqbot]${X}`, m3)
+  };
+}
+function enrichMeta(meta) {
+  const ctx = getRequestContext();
+  if (!ctx) return meta;
+  const trace = {};
+  if (ctx.accountId) trace.accountId = ctx.accountId;
+  if (ctx.messageId) trace.messageId = ctx.messageId;
+  if (ctx.openId) trace.openId = ctx.openId;
+  if (Object.keys(trace).length === 0) return meta;
+  return meta ? { ...trace, ...meta } : trace;
+}
+function frameworkSink() {
+  const resolve2 = () => {
+    try {
+      const r = tryGetQQBotRuntime();
+      if (r?.logging) {
+        const child = r.logging.getChildLogger({ subsystem: "qqbot/core" });
+        return {
+          debug: child.debug?.bind(child),
+          info: child.info.bind(child),
+          warn: child.warn.bind(child),
+          error: child.error.bind(child)
+        };
+      }
+    } catch {
+    }
+    return consoleSink();
+  };
+  return {
+    debug: (msg, meta) => resolve2().debug?.(msg, meta),
+    info: (msg, meta) => resolve2().info(msg, meta),
+    warn: (msg, meta) => resolve2().warn(msg, meta),
+    error: (msg, meta) => resolve2().error(msg, meta)
+  };
+}
+function createPluginLogger(opts = {}) {
+  const output = opts.output ?? (opts.forceConsole ? consoleSink() : frameworkSink());
+  const prefix = opts.prefix ?? "";
+  const fmt = (msg) => prefix ? `${prefix} ${msg}` : msg;
+  const buildChild = (parentPrefix, tag) => createPluginLogger({
+    output,
+    prefix: parentPrefix ? `${parentPrefix}[${tag}]` : `[${tag}]`
+  });
+  return {
+    info: (msg, meta) => output.info(fmt(msg), enrichMeta(meta)),
+    warn: (msg, meta) => output.warn(fmt(msg), enrichMeta(meta)),
+    error: (msg, meta) => output.error(fmt(msg), enrichMeta(meta)),
+    debug: (msg, meta) => output.debug(fmt(msg), enrichMeta(meta)),
+    child: (tag) => buildChild(prefix, tag)
+  };
+}
+var init_plugin_logger = __esm({
+  "src/utils/plugin-logger.ts"() {
+    "use strict";
+    init_request_context();
+    init_runtime();
+  }
+});
+
+// src/features/credential-backup.ts
+function getBackupPath() {
+  return import_node_path3.default.join(getQQBotDataDir("data"), BACKUP_DIR, BACKUP_FILENAME);
+}
+function saveCredentialBackup(accountId, appId, clientSecret) {
+  if (!appId || !clientSecret) return;
+  try {
+    const backupPath = getBackupPath();
+    const dir = import_node_path3.default.dirname(backupPath);
+    if (!import_node_fs3.default.existsSync(dir)) {
+      import_node_fs3.default.mkdirSync(dir, { recursive: true });
+    }
+    const data = {
+      accountId,
+      appId,
+      clientSecret,
+      savedAt: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    const tmpPath = backupPath + ".tmp";
+    import_node_fs3.default.writeFileSync(tmpPath, JSON.stringify(data, null, 2) + "\n", "utf8");
+    import_node_fs3.default.renameSync(tmpPath, backupPath);
+  } catch (err) {
+    backupLog.debug(`save failed: ${err instanceof Error ? err.message : String(err)}`, { accountId });
+  }
+}
+function loadCredentialBackup(accountId) {
+  try {
+    const backupPath = getBackupPath();
+    if (import_node_fs3.default.existsSync(backupPath)) {
+      return readBackupFile(backupPath, accountId);
+    }
+    return null;
+  } catch (err) {
+    backupLog.debug(`load failed: ${err instanceof Error ? err.message : String(err)}`);
+    return null;
+  }
+}
+function readBackupFile(filePath, accountId) {
+  const raw = import_node_fs3.default.readFileSync(filePath, "utf8");
+  const data = JSON.parse(raw);
+  if (!data.appId || !data.clientSecret) return null;
+  if (accountId && data.accountId !== accountId) return null;
+  return data;
+}
+var import_node_fs3, import_node_path3, backupLog, BACKUP_DIR, BACKUP_FILENAME;
+var init_credential_backup = __esm({
+  "src/features/credential-backup.ts"() {
+    "use strict";
+    import_node_fs3 = __toESM(require("fs"), 1);
+    import_node_path3 = __toESM(require("path"), 1);
+    init_platform();
+    init_plugin_logger();
+    backupLog = createPluginLogger({ prefix: "[credential-backup]" });
+    BACKUP_DIR = "credential-backup";
+    BACKUP_FILENAME = "current.json";
+  }
+});
+
+// src/config.ts
+var config_exports = {};
+__export(config_exports, {
+  DEFAULT_ACCOUNT_ID: () => DEFAULT_ACCOUNT_ID,
+  applyQQBotAccountConfig: () => applyQQBotAccountConfig,
+  isGroupAllowed: () => isGroupAllowed,
+  listQQBotAccountIds: () => listQQBotAccountIds,
+  resolveDefaultQQBotAccountId: () => resolveDefaultQQBotAccountId,
+  resolveGroupAllowFrom: () => resolveGroupAllowFrom,
+  resolveGroupCoalesceConfig: () => resolveGroupCoalesceConfig,
+  resolveGroupCoalesceEnabled: () => resolveGroupCoalesceEnabled,
+  resolveGroupConfig: () => resolveGroupConfig,
+  resolveGroupConfigFromAccount: () => resolveGroupConfigFromAccount,
+  resolveGroupName: () => resolveGroupName,
+  resolveGroupPolicy: () => resolveGroupPolicy,
+  resolveGroupPrompt: () => resolveGroupPrompt,
+  resolveHistoryLimit: () => resolveHistoryLimit,
+  resolveIgnoreOtherMentions: () => resolveIgnoreOtherMentions,
+  resolveMentionPatterns: () => resolveMentionPatterns,
+  resolveQQBotAccount: () => resolveQQBotAccount,
+  resolveQQBotEnvAppId: () => resolveQQBotEnvAppId,
+  resolveQQBotEnvClientSecret: () => resolveQQBotEnvClientSecret,
+  resolveRequireMention: () => resolveRequireMention,
+  resolveToolPolicy: () => resolveToolPolicy,
+  resolveUserAgentSuffix: () => resolveUserAgentSuffix
+});
+function resolveMentionPatterns(cfg, agentId) {
+  if (agentId) {
+    const agents = cfg.agents;
+    const entry = agents?.list?.find((a) => a.id?.trim().toLowerCase() === agentId.trim().toLowerCase());
+    const agentGroupChat = entry?.groupChat;
+    if (agentGroupChat && Object.hasOwn(agentGroupChat, "mentionPatterns")) {
+      return agentGroupChat.mentionPatterns ?? [];
+    }
+  }
+  const globalGroupChat = cfg?.messages?.groupChat;
+  if (globalGroupChat && typeof globalGroupChat === "object" && Object.hasOwn(globalGroupChat, "mentionPatterns")) {
+    return globalGroupChat.mentionPatterns ?? [];
+  }
+  return [];
+}
+function evaluateMatchedGroupAccessForPolicy(params) {
+  if (params.groupPolicy === "disabled") {
+    return { allowed: false, groupPolicy: params.groupPolicy, reason: "disabled" };
+  }
+  if (params.groupPolicy === "allowlist") {
+    if (params.requireMatchInput && !params.hasMatchInput) {
+      return { allowed: false, groupPolicy: params.groupPolicy, reason: "missing_match_input" };
+    }
+    if (!params.allowlistConfigured) {
+      return { allowed: false, groupPolicy: params.groupPolicy, reason: "empty_allowlist" };
+    }
+    if (!params.allowlistMatched) {
+      return { allowed: false, groupPolicy: params.groupPolicy, reason: "not_allowlisted" };
+    }
+  }
+  return { allowed: true, groupPolicy: params.groupPolicy, reason: "allowed" };
+}
+function resolveGroupPolicy(cfg, accountId) {
+  const account = resolveQQBotAccount(cfg, accountId);
+  return account.config?.groupPolicy ?? DEFAULT_GROUP_POLICY;
+}
+function resolveGroupAllowFrom(cfg, accountId) {
+  const account = resolveQQBotAccount(cfg, accountId);
+  return (account.config?.groupAllowFrom ?? []).map((id) => String(id).trim().toUpperCase());
+}
+function isGroupAllowed(cfg, groupOpenid, accountId) {
+  const account = resolveQQBotAccount(cfg, accountId);
+  const policy = account.config?.groupPolicy ?? DEFAULT_GROUP_POLICY;
+  const allowList = (account.config?.groupAllowFrom ?? []).map((id) => String(id).trim().toUpperCase());
+  const allowlistConfigured = allowList.length > 0;
+  const allowlistMatched = allowList.some((id) => id === "*" || id === groupOpenid.toUpperCase());
+  return evaluateMatchedGroupAccessForPolicy({
+    groupPolicy: policy,
+    allowlistConfigured,
+    allowlistMatched
+  }).allowed;
+}
+function resolveGroupConfigFromAccount(account, groupOpenid) {
+  const groups = account.config?.groups ?? {};
+  const wildcardCfg = groups["*"] ?? {};
+  const specificCfg = groups[groupOpenid] ?? {};
+  const accountDefaultRequireMention = account.config?.defaultRequireMention ?? DEFAULT_GROUP_CONFIG.requireMention;
+  const accountDefaultCoalesce = account.config?.groupCoalesce ?? DEFAULT_GROUP_COALESCE_CONFIG;
+  const coalesce = {
+    enabled: specificCfg.coalesce?.enabled ?? wildcardCfg.coalesce?.enabled ?? accountDefaultCoalesce.enabled ?? DEFAULT_GROUP_COALESCE_CONFIG.enabled
+  };
+  return {
+    requireMention: specificCfg.requireMention ?? wildcardCfg.requireMention ?? accountDefaultRequireMention,
+    ignoreOtherMentions: specificCfg.ignoreOtherMentions ?? wildcardCfg.ignoreOtherMentions ?? DEFAULT_GROUP_CONFIG.ignoreOtherMentions,
+    toolPolicy: specificCfg.toolPolicy ?? wildcardCfg.toolPolicy ?? DEFAULT_GROUP_CONFIG.toolPolicy,
+    name: specificCfg.name ?? wildcardCfg.name ?? DEFAULT_GROUP_CONFIG.name,
+    prompt: specificCfg.prompt ?? wildcardCfg.prompt ?? DEFAULT_GROUP_PROMPT,
+    historyLimit: specificCfg.historyLimit ?? wildcardCfg.historyLimit ?? DEFAULT_GROUP_CONFIG.historyLimit,
+    historyMode: specificCfg.historyMode ?? wildcardCfg.historyMode ?? DEFAULT_GROUP_CONFIG.historyMode,
+    unmentionedInbound: specificCfg.unmentionedInbound ?? wildcardCfg.unmentionedInbound ?? DEFAULT_GROUP_CONFIG.unmentionedInbound,
+    coalesce
+  };
+}
+function resolveGroupConfig(cfg, groupOpenid, accountId) {
+  return resolveGroupConfigFromAccount(resolveQQBotAccount(cfg, accountId), groupOpenid);
+}
+function resolveHistoryLimit(cfg, groupOpenid, accountId) {
+  return Math.max(0, resolveGroupConfig(cfg, groupOpenid, accountId).historyLimit);
+}
+function resolveGroupPrompt(cfg, groupOpenid, accountId) {
+  return resolveGroupConfig(cfg, groupOpenid, accountId).prompt;
+}
+function resolveRequireMention(cfg, groupOpenid, accountId) {
+  return resolveGroupConfig(cfg, groupOpenid, accountId).requireMention;
+}
+function resolveIgnoreOtherMentions(cfg, groupOpenid, accountId) {
+  return resolveGroupConfig(cfg, groupOpenid, accountId).ignoreOtherMentions;
+}
+function resolveToolPolicy(cfg, groupOpenid, accountId) {
+  return resolveGroupConfig(cfg, groupOpenid, accountId).toolPolicy;
+}
+function resolveGroupName(cfg, groupOpenid, accountId) {
+  const name = resolveGroupConfig(cfg, groupOpenid, accountId).name;
+  return name || groupOpenid.slice(0, 8);
+}
+function resolveUserAgentSuffix(cfg) {
+  const qqbot = cfg.channels?.qqbot;
+  return qqbot?.userAgentSuffix ? String(qqbot.userAgentSuffix).trim() : "";
+}
+function normalizeAppId(raw) {
+  if (raw === null || raw === void 0) return "";
+  return String(raw).trim();
+}
+function firstNonEmptyEnv(...values) {
+  for (const value of values) {
+    if (value?.trim()) return value.trim();
+  }
+  return "";
+}
+function resolveQQBotEnvAppId() {
+  return firstNonEmptyEnv(process.env.QQBOT_APPID);
+}
+function resolveQQBotEnvClientSecret() {
+  return firstNonEmptyEnv(process.env.QQBOT_SECRET);
+}
+function listQQBotAccountIds(cfg) {
+  const ids = /* @__PURE__ */ new Set();
+  const qqbot = cfg.channels?.qqbot;
+  if (qqbot?.appId || resolveQQBotEnvAppId()) {
+    ids.add(DEFAULT_ACCOUNT_ID);
+  }
+  if (qqbot?.accounts) {
+    for (const accountId of Object.keys(qqbot.accounts)) {
+      if (qqbot.accounts[accountId]?.appId) {
+        ids.add(accountId);
+      }
+    }
+  }
+  return Array.from(ids);
+}
+function accountShapeRunnable(params) {
+  if (!params.appId || !params.enabled) return false;
+  if (params.hasSecretSource) return true;
+  try {
+    return loadCredentialBackup(params.accountId) !== null;
+  } catch {
+    return false;
+  }
 }
-function tryGetQQBotRuntime() {
-  return runtime;
+function resolveDefaultQQBotAccountId(cfg) {
+  const qqbot = cfg.channels?.qqbot;
+  if (qqbot?.appId || resolveQQBotEnvAppId()) {
+    const runnable = accountShapeRunnable({
+      appId: normalizeAppId(qqbot?.appId) || normalizeAppId(resolveQQBotEnvAppId()),
+      enabled: qqbot?.enabled !== false,
+      hasSecretSource: Boolean(
+        qqbot?.clientSecret || qqbot?.clientSecretFile || resolveQQBotEnvClientSecret()
+      ),
+      accountId: DEFAULT_ACCOUNT_ID
+    });
+    if (runnable) return DEFAULT_ACCOUNT_ID;
+  }
+  if (qqbot?.accounts) {
+    for (const [accountId, account] of Object.entries(qqbot.accounts)) {
+      if (!account) continue;
+      const runnable = accountShapeRunnable({
+        appId: normalizeAppId(account.appId),
+        enabled: account.enabled !== false,
+        hasSecretSource: Boolean(account.clientSecret || account.clientSecretFile),
+        accountId
+      });
+      if (runnable) return accountId;
+    }
+    const ids = Object.keys(qqbot.accounts);
+    if (ids.length > 0 && ids.every((id) => !qqbot.accounts?.[id]?.appId)) {
+      return ids[0];
+    }
+  }
+  return DEFAULT_ACCOUNT_ID;
 }
-var runtime, exitHooksInstalled;
-var init_runtime = __esm({
-  "src/runtime.ts"() {
-    "use strict";
-    init_bot_instance();
-    init_ref_index_store();
-    init_pkg_version();
-    runtime = null;
-    exitHooksInstalled = false;
+function resolveQQBotAccount(cfg, accountId) {
+  const resolvedAccountId = accountId ?? resolveDefaultQQBotAccountId(cfg);
+  const qqbot = cfg.channels?.qqbot;
+  let accountConfig = {};
+  let appId = "";
+  let clientSecret = "";
+  let secretSource = "none";
+  if (resolvedAccountId === DEFAULT_ACCOUNT_ID) {
+    const { accounts: _accounts, ...topLevelConfig } = qqbot ?? {};
+    accountConfig = {
+      ...topLevelConfig,
+      markdownSupport: qqbot?.markdownSupport ?? true
+    };
+    appId = normalizeAppId(qqbot?.appId);
+  } else {
+    const account = qqbot?.accounts?.[resolvedAccountId];
+    accountConfig = account ?? {};
+    appId = normalizeAppId(account?.appId);
+  }
+  if (accountConfig.clientSecret) {
+    clientSecret = accountConfig.clientSecret;
+    secretSource = "config";
+  } else if (accountConfig.clientSecretFile) {
+    secretSource = "file";
+  } else if (resolvedAccountId === DEFAULT_ACCOUNT_ID && resolveQQBotEnvClientSecret()) {
+    clientSecret = resolveQQBotEnvClientSecret();
+    secretSource = "env";
+  }
+  if (!appId && resolvedAccountId === DEFAULT_ACCOUNT_ID) {
+    appId = normalizeAppId(resolveQQBotEnvAppId());
   }
-});
-
-// src/utils/plugin-logger.ts
-function consoleSink() {
-  const C2 = "\x1B[36m", Y = "\x1B[33m", R = "\x1B[31m", G = "\x1B[90m", X = "\x1B[0m";
   return {
-    debug: (m3) => console.debug(`${G}[qqbot]${X}`, m3),
-    info: (m3) => console.log(`${C2}[qqbot]${X}`, m3),
-    warn: (m3) => console.warn(`${Y}[qqbot]${X}`, m3),
-    error: (m3) => console.error(`${R}[qqbot]${X}`, m3)
+    accountId: resolvedAccountId,
+    name: accountConfig.name,
+    enabled: accountConfig.enabled !== false,
+    appId,
+    clientSecret,
+    secretSource,
+    systemPrompt: accountConfig.systemPrompt,
+    markdownSupport: accountConfig.markdownSupport !== false,
+    commandPanelNative: accountConfig.commands?.native !== false,
+    userAgentSuffix: resolveUserAgentSuffix(cfg),
+    config: accountConfig
   };
 }
-function enrichMeta(meta) {
-  const ctx = getRequestContext();
-  if (!ctx) return meta;
-  const trace = {};
-  if (ctx.accountId) trace.accountId = ctx.accountId;
-  if (ctx.messageId) trace.messageId = ctx.messageId;
-  if (ctx.openId) trace.openId = ctx.openId;
-  if (Object.keys(trace).length === 0) return meta;
-  return meta ? { ...trace, ...meta } : trace;
-}
-function frameworkSink() {
-  const resolve2 = () => {
-    try {
-      const r = tryGetQQBotRuntime();
-      if (r?.logging) {
-        const child = r.logging.getChildLogger({ subsystem: "qqbot/core" });
-        return {
-          debug: child.debug?.bind(child),
-          info: child.info.bind(child),
-          warn: child.warn.bind(child),
-          error: child.error.bind(child)
-        };
+function applyQQBotAccountConfig(cfg, accountId, input) {
+  const next = { ...cfg };
+  if (accountId === DEFAULT_ACCOUNT_ID) {
+    const existingConfig = next.channels?.qqbot || {};
+    const allowFrom = existingConfig.allowFrom ?? ["*"];
+    next.channels = {
+      ...next.channels,
+      qqbot: {
+        ...next.channels?.qqbot || {},
+        enabled: true,
+        allowFrom,
+        ...input.appId ? { appId: input.appId } : {},
+        ...input.clientSecret ? { clientSecret: input.clientSecret } : input.clientSecretFile ? { clientSecretFile: input.clientSecretFile } : {},
+        ...input.name ? { name: input.name } : {}
       }
-    } catch {
-    }
-    return consoleSink();
-  };
-  return {
-    debug: (msg, meta) => resolve2().debug?.(msg, meta),
-    info: (msg, meta) => resolve2().info(msg, meta),
-    warn: (msg, meta) => resolve2().warn(msg, meta),
-    error: (msg, meta) => resolve2().error(msg, meta)
-  };
+    };
+  } else {
+    const existingAccountConfig = next.channels?.qqbot?.accounts?.[accountId] || {};
+    const allowFrom = existingAccountConfig.allowFrom ?? ["*"];
+    next.channels = {
+      ...next.channels,
+      qqbot: {
+        ...next.channels?.qqbot || {},
+        enabled: true,
+        accounts: {
+          ...next.channels?.qqbot?.accounts || {},
+          [accountId]: {
+            ...next.channels?.qqbot?.accounts?.[accountId] || {},
+            enabled: true,
+            allowFrom,
+            ...input.appId ? { appId: input.appId } : {},
+            ...input.clientSecret ? { clientSecret: input.clientSecret } : input.clientSecretFile ? { clientSecretFile: input.clientSecretFile } : {},
+            ...input.name ? { name: input.name } : {}
+          }
+        }
+      }
+    };
+  }
+  return next;
 }
-function createPluginLogger(opts = {}) {
-  const output = opts.output ?? (opts.forceConsole ? consoleSink() : frameworkSink());
-  const prefix = opts.prefix ?? "";
-  const fmt = (msg) => prefix ? `${prefix} ${msg}` : msg;
-  const buildChild = (parentPrefix, tag) => createPluginLogger({
-    output,
-    prefix: parentPrefix ? `${parentPrefix}[${tag}]` : `[${tag}]`
-  });
-  return {
-    info: (msg, meta) => output.info(fmt(msg), enrichMeta(meta)),
-    warn: (msg, meta) => output.warn(fmt(msg), enrichMeta(meta)),
-    error: (msg, meta) => output.error(fmt(msg), enrichMeta(meta)),
-    debug: (msg, meta) => output.debug(fmt(msg), enrichMeta(meta)),
-    child: (tag) => buildChild(prefix, tag)
-  };
+function resolveGroupCoalesceConfig(cfg, groupOpenid, accountId) {
+  return resolveGroupConfig(cfg, groupOpenid, accountId).coalesce;
 }
-var init_plugin_logger = __esm({
-  "src/utils/plugin-logger.ts"() {
+function resolveGroupCoalesceEnabled(cfg, groupOpenid, accountId) {
+  return resolveGroupCoalesceConfig(cfg, groupOpenid, accountId).enabled;
+}
+var DEFAULT_ACCOUNT_ID, DEFAULT_GROUP_POLICY, DEFAULT_GROUP_HISTORY_LIMIT, DEFAULT_GROUP_COALESCE_CONFIG, DEFAULT_GROUP_CONFIG, DEFAULT_GROUP_PROMPT;
+var init_config = __esm({
+  "src/config.ts"() {
     "use strict";
-    init_request_context();
-    init_runtime();
+    init_credential_backup();
+    DEFAULT_ACCOUNT_ID = "default";
+    DEFAULT_GROUP_POLICY = "open";
+    DEFAULT_GROUP_HISTORY_LIMIT = 20;
+    DEFAULT_GROUP_COALESCE_CONFIG = {
+      enabled: true
+    };
+    DEFAULT_GROUP_CONFIG = {
+      requireMention: true,
+      ignoreOtherMentions: false,
+      toolPolicy: "restricted",
+      name: "",
+      historyLimit: DEFAULT_GROUP_HISTORY_LIMIT,
+      historyMode: "clear",
+      unmentionedInbound: "user_request",
+      coalesce: DEFAULT_GROUP_COALESCE_CONFIG
+    };
+    DEFAULT_GROUP_PROMPT = [
+      "\u82E5\u53D1\u9001\u8005\u4E3A\u673A\u5668\u4EBA\uFF0C\u4EC5\u5728\u5BF9\u65B9\u660E\u786E@\u4F60\u63D0\u95EE\u6216\u8BF7\u6C42\u534F\u52A9\u5177\u4F53\u4EFB\u52A1\u65F6\uFF0C\u4EE5\u7B80\u6D01\u660E\u4E86\u7684\u5185\u5BB9\u56DE\u590D\uFF0C",
+      "\u907F\u514D\u4E0E\u5176\u4ED6\u673A\u5668\u4EBA\u4EA7\u751F\u62A2\u7B54\u6216\u591A\u8F6E\u65E0\u610F\u4E49\u5BF9\u8BDD\u3002",
+      "\u5728\u7FA4\u804A\u4E2D\u4F18\u5148\u8BA9\u4EBA\u7C7B\u7528\u6237\u7684\u6D88\u606F\u5F97\u5230\u54CD\u5E94\uFF0C\u673A\u5668\u4EBA\u4E4B\u95F4\u4FDD\u6301\u534F\u4F5C\u800C\u975E\u7ADE\u4E89\uFF0C\u786E\u4FDD\u5BF9\u8BDD\u6709\u5E8F\u4E0D\u5237\u5C4F\u3002"
+    ].join("");
   }
 });
 
@@ -10586,14 +10718,15 @@ async function sendMedia2(params) {
     return { error: resolved.error };
   }
   const kind = params.mediaKind ?? (params.mimeType ? inferMediaKindFromMime(params.mimeType) : void 0) ?? inferMediaKind(resolved.path);
-  const gw = getGateway(accountId);
-  if (!gw) {
-    return { error: `Bot "${accountId}" not running` };
+  const sendGateway = resolveGatewayForSend(accountId);
+  if (!sendGateway) {
+    return { error: notRunningError(accountId) };
   }
+  const gw = sendGateway.gw;
   const target = parseTarget(params.to);
   const reservation = params.quotaReserved || !params.replyToId ? { canReply: Boolean(params.replyToId), rollback: () => {
   } } : checkAndConsumePassiveReplyQuota({
-    accountId,
+    accountId: sendGateway.accountId,
     msgId: params.replyToId,
     scope: target.scope,
     log: log5
@@ -10845,58 +10978,7 @@ var import_channel_core = require("openclaw/plugin-sdk/channel-core");
 var import_account_id = require("openclaw/plugin-sdk/account-id");
 var import_core = require("openclaw/plugin-sdk/core");
 init_config();
-
-// src/features/credential-backup.ts
-var import_node_fs3 = __toESM(require("fs"), 1);
-var import_node_path3 = __toESM(require("path"), 1);
-init_platform();
-init_plugin_logger();
-var backupLog = createPluginLogger({ prefix: "[credential-backup]" });
-var BACKUP_DIR = "credential-backup";
-var BACKUP_FILENAME = "current.json";
-function getBackupPath() {
-  return import_node_path3.default.join(getQQBotDataDir("data"), BACKUP_DIR, BACKUP_FILENAME);
-}
-function saveCredentialBackup(accountId, appId, clientSecret) {
-  if (!appId || !clientSecret) return;
-  try {
-    const backupPath = getBackupPath();
-    const dir = import_node_path3.default.dirname(backupPath);
-    if (!import_node_fs3.default.existsSync(dir)) {
-      import_node_fs3.default.mkdirSync(dir, { recursive: true });
-    }
-    const data = {
-      accountId,
-      appId,
-      clientSecret,
-      savedAt: (/* @__PURE__ */ new Date()).toISOString()
-    };
-    const tmpPath = backupPath + ".tmp";
-    import_node_fs3.default.writeFileSync(tmpPath, JSON.stringify(data, null, 2) + "\n", "utf8");
-    import_node_fs3.default.renameSync(tmpPath, backupPath);
-  } catch (err) {
-    backupLog.debug(`save failed: ${err instanceof Error ? err.message : String(err)}`, { accountId });
-  }
-}
-function loadCredentialBackup(accountId) {
-  try {
-    const backupPath = getBackupPath();
-    if (import_node_fs3.default.existsSync(backupPath)) {
-      return readBackupFile(backupPath, accountId);
-    }
-    return null;
-  } catch (err) {
-    backupLog.debug(`load failed: ${err instanceof Error ? err.message : String(err)}`);
-    return null;
-  }
-}
-function readBackupFile(filePath, accountId) {
-  const raw = import_node_fs3.default.readFileSync(filePath, "utf8");
-  const data = JSON.parse(raw);
-  if (!data.appId || !data.clientSecret) return null;
-  if (accountId && data.accountId !== accountId) return null;
-  return data;
-}
+init_credential_backup();
 
 // src/setup/surface.ts
 init_setup();
@@ -14747,8 +14829,13 @@ var StreamingController = class {
   session = null;
   /** QQ 已接受的最新文本 — 单源真理 */
   lastAcceptedFull = "";
-  /** 已成功发送的分片数（降级：=0 则走静态消息兜底） */
+  /** 已成功发送的分片数（降级：=0 且无外部投递则走静态消息兜底） */
   sentChunkCount = 0;
+  /**
+   * 标记：内容已通过非流式通道成功投递（如 ask_user 按钮卡片）。
+   * 置 true 后 handleFinalize 不再走 fallback 路径，避免框架误报 outcome=error。
+   */
+  _deliveredExternally = false;
   /** 同步标志：收到第一个 onPartialReply 即置 true（不等 async 完成） */
   _hasStarted = false;
   /** 串行队列 */
@@ -14781,7 +14868,14 @@ var StreamingController = class {
     return this.phase === "done" || this.phase === "failed";
   }
   get shouldFallbackToStatic() {
-    return this.isTerminal && this.sentChunkCount === 0;
+    return this.isTerminal && this.sentChunkCount === 0 && !this._deliveredExternally;
+  }
+  /**
+   * 告知控制器内容已通过外部通道投递（如 ask_user 卡片）。
+   * 后续 finalize() 不会走 fallback 路径，框架不会误报 outcome=error。
+   */
+  markDeliveredExternally() {
+    this._deliveredExternally = true;
   }
   // ── 入口 ──
   onPartialReply(text) {
@@ -14883,6 +14977,8 @@ var StreamingController = class {
         }
       } else if (this.sentChunkCount > 0 && this.lastAcceptedFull) {
         this.transition("failed", "finalize:no_sendstatic");
+      } else if (this._deliveredExternally) {
+        this.transition("done", "finalize");
       } else {
         this.transition("done", "finalize:fallback");
       }
@@ -14894,8 +14990,8 @@ var StreamingController = class {
       this.deps.log?.info(`stream done chunks=${this.sentChunkCount} chars=${this.lastAcceptedFull.length}`);
       return;
     }
-    if (this.sentChunkCount > 0) {
-      this.transition("done", "finalize:no_session");
+    if (this.sentChunkCount > 0 || this._deliveredExternally) {
+      this.transition("done", this.sentChunkCount > 0 ? "finalize:no_session" : "finalize");
     } else {
       this.transition("done", "finalize:fallback");
     }
@@ -15129,6 +15225,7 @@ async function dispatchToOpenClaw(ctx, msg, account, runtime2, log5) {
             try {
               await bot.sendTextWithKeyboard(replyTarget, text, keyboard);
               outboundSendOk++;
+              streamingController?.markDeliveredExternally();
               dlog?.debug(`[question] sent ask_user with keyboard questionId=${questionId} options=${optionValues.length}`);
               return;
             } catch (err) {
@@ -15154,6 +15251,7 @@ async function dispatchToOpenClaw(ctx, msg, account, runtime2, log5) {
                 await bot.sendTextWithKeyboard(replyTarget, cardText, keyboard);
                 outboundSendOk++;
               }
+              streamingController?.markDeliveredExternally();
               dlog?.debug(`[question] sent multi-question ask_user questionId=${questionId} questions=${questions.length}`);
               return;
             } catch (err) {
@@ -16745,6 +16843,7 @@ function resolveMediaSource(source) {
 // src/gateway/lifecycle.ts
 init_plugin_logger();
 init_outbound_service();
+init_credential_backup();
 
 // src/features/command-panel.ts
 var import_native_command_registry = require("openclaw/plugin-sdk/native-command-registry");
@@ -17109,7 +17208,7 @@ async function stopAccountGracefully(params) {
       log5?.error(`[qqbot:${accountId}] gateway stop error: ${err instanceof Error ? err.message : String(err)}`);
     }
   }
-  unregisterGateway(accountId);
+  unregisterGateway(accountId, gw);
 }
 async function logoutAndClearCredentials(params) {
   const { accountId, cfg } = params;