@openclaw-china/qqbot 2026.3.29 → 2026.4.23

package/dist/index.js

@@ -4214,6 +4214,10 @@ var coerce = {
 var NEVER = INVALID;
 
 // src/config.ts
+var QQBOT_CHANNEL_ID = "qqbot";
+var QQBOT_CONFIG_CHANNEL_ID = "qqbot-china";
+var QQBOT_CONFIG_PREFIX = `channels.${QQBOT_CONFIG_CHANNEL_ID}`;
+var QQBOT_CONFIG_PREFIXES = [QQBOT_CONFIG_PREFIX];
 function toTrimmedString(value) {
   if (value === void 0 || value === null) return void 0;
   const next = String(value).trim();
@@ -4325,9 +4329,42 @@ function resolveQQBotStreaming(config) {
 function resolveInboundMediaTempDir() {
   return DEFAULT_INBOUND_MEDIA_TEMP_DIR;
 }
+function asQQBotConfig(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return void 0;
+  }
+  return value;
+}
+function resolveQQBotChannelConfig(cfg) {
+  return asQQBotConfig(cfg?.channels?.[QQBOT_CONFIG_CHANNEL_ID]);
+}
+function withQQBotChannelConfig(cfg, qqbotConfig) {
+  const nextChannels = { ...cfg.channels ?? {} };
+  if (qqbotConfig) {
+    nextChannels[QQBOT_CONFIG_CHANNEL_ID] = qqbotConfig;
+  } else {
+    delete nextChannels[QQBOT_CONFIG_CHANNEL_ID];
+  }
+  if (Object.keys(nextChannels).length === 0) {
+    const next = { ...cfg };
+    delete next.channels;
+    return next;
+  }
+  return {
+    ...cfg,
+    channels: nextChannels
+  };
+}
+function stripQQBotChannelPrefix(value) {
+  let next = value.trim();
+  if (next.slice(0, QQBOT_CHANNEL_ID.length + 1).toLowerCase() === `${QQBOT_CHANNEL_ID}:`) {
+    next = next.slice(QQBOT_CHANNEL_ID.length + 1).trim();
+  }
+  return next;
+}
 var DEFAULT_ACCOUNT_ID = "default";
 function listConfiguredAccountIds(cfg) {
-  const accounts = cfg.channels?.qqbot?.accounts;
+  const accounts = resolveQQBotChannelConfig(cfg)?.accounts;
   if (!accounts || typeof accounts !== "object") return [];
   return Object.keys(accounts).filter(Boolean);
 }
@@ -4337,19 +4374,19 @@ function listQQBotAccountIds(cfg) {
   return ids.sort((a, b) => a.localeCompare(b));
 }
 function resolveDefaultQQBotAccountId(cfg) {
-  const qqbotConfig = cfg.channels?.qqbot;
+  const qqbotConfig = resolveQQBotChannelConfig(cfg);
   if (qqbotConfig?.defaultAccount?.trim()) return qqbotConfig.defaultAccount.trim();
   const ids = listQQBotAccountIds(cfg);
   if (ids.includes(DEFAULT_ACCOUNT_ID)) return DEFAULT_ACCOUNT_ID;
   return ids[0] ?? DEFAULT_ACCOUNT_ID;
 }
 function resolveAccountConfig(cfg, accountId) {
-  const accounts = cfg.channels?.qqbot?.accounts;
+  const accounts = resolveQQBotChannelConfig(cfg)?.accounts;
   if (!accounts || typeof accounts !== "object") return void 0;
   return accounts[accountId];
 }
 function mergeQQBotAccountConfig(cfg, accountId) {
-  const base = cfg.channels?.qqbot ?? {};
+  const base = resolveQQBotChannelConfig(cfg) ?? {};
   const { accounts: _ignored, defaultAccount: _ignored2, ...baseConfig } = base;
   const account = resolveAccountConfig(cfg, accountId) ?? {};
   const mergedDisplayAliases = {
@@ -4387,41 +4424,35 @@ function isPromptCancelled(value) {
   return typeof value === "symbol";
 }
 function setQQBotCredentials(params) {
-  const existing = params.cfg.channels?.qqbot ?? {};
+  const existing = resolveQQBotChannelConfig(params.cfg) ?? {};
   if (params.accountId === DEFAULT_ACCOUNT_ID) {
-    return {
-      ...params.cfg,
-      channels: {
-        ...params.cfg.channels,
-        qqbot: {
-          ...existing,
-          enabled: true,
-          appId: params.appId,
-          clientSecret: params.clientSecret
-        }
+    return withQQBotChannelConfig(
+      params.cfg,
+      {
+        ...existing,
+        enabled: true,
+        appId: params.appId,
+        clientSecret: params.clientSecret
       }
-    };
+    );
   }
   const accounts = existing.accounts ?? {};
-  return {
-    ...params.cfg,
-    channels: {
-      ...params.cfg.channels,
-      qqbot: {
-        ...existing,
-        enabled: true,
-        accounts: {
-          ...accounts,
-          [params.accountId]: {
-            ...accounts[params.accountId],
-            enabled: true,
-            appId: params.appId,
-            clientSecret: params.clientSecret
-          }
+  return withQQBotChannelConfig(
+    params.cfg,
+    {
+      ...existing,
+      enabled: true,
+      accounts: {
+        ...accounts,
+        [params.accountId]: {
+          ...accounts[params.accountId],
+          enabled: true,
+          appId: params.appId,
+          clientSecret: params.clientSecret
         }
       }
     }
-  };
+  );
 }
 async function noteQQBotCredentialHelp(prompter) {
   await prompter.note(
@@ -4431,13 +4462,13 @@ async function noteQQBotCredentialHelp(prompter) {
       "3) \u5728\u5F00\u53D1\u8BBE\u7F6E\u4E2D\u914D\u7F6E\u6C99\u7BB1\u6210\u5458\u6216\u6D4B\u8BD5\u7FA4",
       "4) \u914D\u7F6E\u5B8C\u6210\u540E\u53EF\u4F7F\u7528 openclaw gateway \u542F\u52A8\u8FDE\u63A5",
       "",
-      '\u547D\u4EE4\u884C\u4E5F\u652F\u6301\uFF1Aopenclaw channels add --channel qqbot --token "AppID:ClientSecret"'
+      `\u547D\u4EE4\u884C\u4E5F\u652F\u6301\uFF1Aopenclaw channels add --channel ${QQBOT_CHANNEL_ID} --token "AppID:ClientSecret"`
     ].join("\n"),
     "QQ Bot \u914D\u7F6E"
   );
 }
 function resolveOnboardingAccountId(params) {
-  const override = params.accountOverrides?.qqbot?.trim();
+  const override = params.accountOverrides?.[QQBOT_CONFIG_CHANNEL_ID]?.trim();
   if (override) return override;
   const defaultAccountId = resolveDefaultQQBotAccountId(params.cfg);
   const accountIds = listQQBotAccountIds(params.cfg);
@@ -4454,7 +4485,7 @@ function resolveOnboardingAccountId(params) {
   }).then((selected) => isPromptCancelled(selected) ? defaultAccountId : selected);
 }
 var qqbotOnboardingAdapter = {
-  channel: "qqbot",
+  channel: QQBOT_CHANNEL_ID,
   getStatus: async (params) => {
     const accountIds = listQQBotAccountIds(params.cfg);
     const configuredAccountId = accountIds.find(
@@ -4466,7 +4497,7 @@ var qqbotOnboardingAdapter = {
       configuredAccountId && configuredAccountId !== DEFAULT_ACCOUNT_ID ? `QQ Bot: \u5DF2\u914D\u7F6E (${configuredAccountId})` : `QQ Bot: \u5DF2\u914D\u7F6E${defaultAccountId !== DEFAULT_ACCOUNT_ID ? ` (default=${defaultAccountId})` : ""}`
     ] : ["QQ Bot: \u9700\u8981 AppID \u548C ClientSecret"];
     return {
-      channel: "qqbot",
+      channel: QQBOT_CHANNEL_ID,
       configured,
       statusLines,
       selectionHint: configured ? "\u5DF2\u914D\u7F6E" : "\u9700\u8981 AppID \u548C ClientSecret",
@@ -4520,15 +4551,9 @@ var qqbotOnboardingAdapter = {
     }
     return { cfg: next, accountId };
   },
-  disable: (cfg) => ({
-    ...cfg,
-    channels: {
-      ...cfg.channels,
-      qqbot: {
-        ...cfg.channels?.qqbot ?? {},
-        enabled: false
-      }
-    }
+  disable: (cfg) => withQQBotChannelConfig(cfg, {
+    ...resolveQQBotChannelConfig(cfg) ?? {},
+    enabled: false
   })
 };
 
@@ -6572,9 +6597,10 @@ var CONFIG_FILE_PATH = join(OPENCLAW_HOME, "openclaw.json");
 var ANSI_RESET = "\x1B[0m";
 var ANSI_LINK = "\x1B[1;4;96m";
 var ANSI_BORDER = "\x1B[92m";
+var QQBOT_CHANNEL_ID2 = "qqbot-china";
 var CHANNEL_ORDER = [
   "dingtalk",
-  "qqbot",
+  QQBOT_CHANNEL_ID2,
   "wecom",
   "wecom-app",
   "wecom-kf",
@@ -6588,7 +6614,7 @@ var CHANNEL_DISPLAY_LABELS = {
   "wecom-app": "WeCom App\uFF08\u81EA\u5EFA\u5E94\u7528-\u53EF\u63A5\u5165\u5FAE\u4FE1\uFF09",
   "wecom-kf": "WeCom KF\uFF08\u5FAE\u4FE1\u5BA2\u670D\uFF09",
   "wechat-mp": "WeChat MP\uFF08\u5FAE\u4FE1\u516C\u4F17\u53F7\uFF09",
-  qqbot: "QQBot\uFF08QQ \u673A\u5668\u4EBA\uFF09"
+  "qqbot-china": "QQBot\uFF08QQ \u673A\u5668\u4EBA\uFF09"
 };
 var CHANNEL_GUIDE_LINKS = {
   dingtalk: `${GUIDES_BASE}/dingtalk/configuration.md`,
@@ -6597,7 +6623,7 @@ var CHANNEL_GUIDE_LINKS = {
   "wecom-app": `${GUIDES_BASE}/wecom-app/configuration.md`,
   "wecom-kf": "https://github.com/BytePioneer-AI/openclaw-china/blob/main/extensions/wecom-kf/README.md",
   "wechat-mp": `${GUIDES_BASE}/wechat-mp/configuration.md`,
-  qqbot: `${GUIDES_BASE}/qqbot/configuration.md`
+  "qqbot-china": `${GUIDES_BASE}/qqbot/configuration.md`
 };
 var CHINA_CLI_STATE_KEY = /* @__PURE__ */ Symbol.for("@openclaw-china/china-cli-state");
 var PromptCancelledError = class extends Error {
@@ -6799,7 +6825,7 @@ function isChannelConfigured(cfg, channelId) {
       return hasNonEmptyString(channelCfg.clientId) && hasNonEmptyString(channelCfg.clientSecret);
     case "feishu-china":
       return hasNonEmptyString(channelCfg.appId) && hasNonEmptyString(channelCfg.appSecret);
-    case "qqbot":
+    case "qqbot-china":
       return hasNonEmptyString(channelCfg.appId) && hasNonEmptyString(channelCfg.clientSecret);
     case "wecom":
       return hasWecomWsCredentialPair(channelCfg);
@@ -6820,11 +6846,12 @@ function withConfiguredSuffix(cfg, channelId) {
 function mergeChannelConfig(cfg, channelId, patch) {
   const channels = isRecord(cfg.channels) ? { ...cfg.channels } : {};
   const existing = getChannelConfig(cfg, channelId);
-  channels[channelId] = {
+  const nextChannelConfig = {
     ...existing,
     ...patch,
     enabled: true
   };
+  channels[channelId] = nextChannelConfig;
   return {
     ...cfg,
     channels
@@ -7201,8 +7228,8 @@ async function configureWechatMp(prompter, cfg) {
 }
 async function configureQQBot(prompter, cfg) {
   section("\u914D\u7F6E QQBot\uFF08QQ \u673A\u5668\u4EBA\uFF09");
-  showGuideLink("qqbot");
-  const existing = getChannelConfig(cfg, "qqbot");
+  showGuideLink(QQBOT_CHANNEL_ID2);
+  const existing = getChannelConfig(cfg, QQBOT_CHANNEL_ID2);
   const existingAsr = isRecord(existing.asr) ? existing.asr : {};
   const appId = await prompter.askText({
     label: "QQBot appId",
@@ -7239,7 +7266,7 @@ async function configureQQBot(prompter, cfg) {
       required: true
     });
   }
-  return mergeChannelConfig(cfg, "qqbot", {
+  return mergeChannelConfig(cfg, QQBOT_CHANNEL_ID2, {
     appId,
     clientSecret,
     asr
@@ -7259,7 +7286,7 @@ async function configureSingleChannel(channel, prompter, cfg) {
       return configureWecomKf(prompter, cfg);
     case "wechat-mp":
       return configureWechatMp(prompter, cfg);
-    case "qqbot":
+    case "qqbot-china":
       return configureQQBot(prompter, cfg);
     default:
       return cfg;
@@ -7401,7 +7428,7 @@ var SUPPORTED_CHANNELS = [
   "wecom-app",
   "wecom-kf",
   "wechat-mp",
-  "qqbot"
+  "qqbot-china"
 ];
 var CHINA_INSTALL_HINT_SHOWN_KEY = /* @__PURE__ */ Symbol.for("@openclaw-china/china-install-hint-shown");
 function isRecord2(value) {
@@ -8254,12 +8281,8 @@ async function readMediaWithConfig(source, options) {
 }
 
 // src/outbound.ts
-function stripPrefix(value, prefix) {
-  return value.slice(0, prefix.length).toLowerCase() === prefix ? value.slice(prefix.length) : value;
-}
 function parseTarget(to) {
-  let raw = to.trim();
-  raw = stripPrefix(raw, "qqbot:");
+  let raw = stripQQBotChannelPrefix(to);
   const normalizedRaw = raw.toLowerCase();
   if (normalizedRaw.startsWith("group:")) {
     return { kind: "group", id: raw.slice("group:".length) };
@@ -8426,7 +8449,7 @@ var qqbotOutbound = {
     const qqCfg = mergeQQBotAccountConfig(cfg, accountId ?? DEFAULT_ACCOUNT_ID);
     const credentials = resolveQQBotCredentials(qqCfg);
     if (!credentials) {
-      return { channel: "qqbot", error: "QQBot not configured (missing appId/clientSecret)" };
+      return { channel: QQBOT_CHANNEL_ID, error: "QQBot not configured (missing appId/clientSecret)" };
     }
     const target = parseTarget(to);
     const accessToken = await getAccessToken(credentials.appId, credentials.clientSecret);
@@ -8450,7 +8473,7 @@ var qqbotOutbound = {
             content: text,
             markdown
           });
-          return { channel: "qqbot", messageId: result3.id, timestamp: result3.timestamp };
+          return { channel: QQBOT_CHANNEL_ID, messageId: result3.id, timestamp: result3.timestamp };
         }
         let result2;
         try {
@@ -8517,7 +8540,7 @@ var qqbotOutbound = {
             throw retryErr;
           }
         }
-        return { channel: "qqbot", messageId: result2.id, timestamp: result2.timestamp };
+        return { channel: QQBOT_CHANNEL_ID, messageId: result2.id, timestamp: result2.timestamp };
       }
       if (target.kind === "channel") {
         logQQBotOutboundDispatch({
@@ -8535,7 +8558,7 @@ var qqbotOutbound = {
           content: text,
           messageId: replyToId
         });
-        return { channel: "qqbot", messageId: result2.id, timestamp: result2.timestamp };
+        return { channel: QQBOT_CHANNEL_ID, messageId: result2.id, timestamp: result2.timestamp };
       }
       if (!replyToId && !replyEventId) {
         logQQBotOutboundDispatch({
@@ -8556,7 +8579,7 @@ var qqbotOutbound = {
         const refIdx2 = resolveResponseRefIdx(result2);
         recordOutboundC2CRefIndex({ refIdx: refIdx2, accountId, text });
         return {
-          channel: "qqbot",
+          channel: QQBOT_CHANNEL_ID,
           messageId: result2.id,
           timestamp: result2.timestamp,
           ...refIdx2 ? { refIdx: refIdx2 } : {}
@@ -8630,14 +8653,14 @@ var qqbotOutbound = {
       const refIdx = resolveResponseRefIdx(result);
       recordOutboundC2CRefIndex({ refIdx, accountId, text });
       return {
-        channel: "qqbot",
+        channel: QQBOT_CHANNEL_ID,
         messageId: result.id,
         timestamp: result.timestamp,
         ...refIdx ? { refIdx } : {}
       };
     } catch (err) {
       const message = summarizeError(err);
-      return { channel: "qqbot", error: message };
+      return { channel: QQBOT_CHANNEL_ID, error: message };
     }
   },
   sendMedia: async (params) => {
@@ -8645,13 +8668,13 @@ var qqbotOutbound = {
     if (!mediaUrl) {
       const fallbackText = text?.trim() ?? "";
       if (!fallbackText) {
-        return { channel: "qqbot", error: "mediaUrl is required for sendMedia" };
+        return { channel: QQBOT_CHANNEL_ID, error: "mediaUrl is required for sendMedia" };
       }
       return qqbotOutbound.sendText({ cfg, to, text: fallbackText, replyToId, replyEventId, accountId });
     }
     const qqCfg = mergeQQBotAccountConfig(cfg, accountId ?? DEFAULT_ACCOUNT_ID);
     if (!resolveQQBotCredentials(qqCfg)) {
-      return { channel: "qqbot", error: "QQBot not configured (missing appId/clientSecret)" };
+      return { channel: QQBOT_CHANNEL_ID, error: "QQBot not configured (missing appId/clientSecret)" };
     }
     const target = parseTarget(to);
     const trimmedText = text?.trim() ? text.trim() : void 0;
@@ -8738,7 +8761,7 @@ ${mediaUrl}` : mediaUrl;
         });
         if (textResult.error) {
           return {
-            channel: "qqbot",
+            channel: QQBOT_CHANNEL_ID,
             error: `QQBot follow-up text send failed after media delivery: ${textResult.error}`
           };
         }
@@ -8753,14 +8776,14 @@ ${mediaUrl}` : mediaUrl;
         });
       }
       return {
-        channel: "qqbot",
+        channel: QQBOT_CHANNEL_ID,
         messageId: result.id,
         timestamp: result.timestamp,
         ...refIdx ? { refIdx } : {}
       };
     } catch (err) {
       const message = summarizeError(err);
-      return { channel: "qqbot", error: message };
+      return { channel: QQBOT_CHANNEL_ID, error: message };
     }
   },
   sendTyping: async (params) => {
@@ -8768,11 +8791,11 @@ ${mediaUrl}` : mediaUrl;
     const qqCfg = mergeQQBotAccountConfig(cfg, accountId ?? DEFAULT_ACCOUNT_ID);
     const credentials = resolveQQBotCredentials(qqCfg);
     if (!credentials) {
-      return { channel: "qqbot", error: "QQBot not configured (missing appId/clientSecret)" };
+      return { channel: QQBOT_CHANNEL_ID, error: "QQBot not configured (missing appId/clientSecret)" };
     }
     const target = parseTarget(to);
     if (target.kind !== "c2c") {
-      return { channel: "qqbot" };
+      return { channel: QQBOT_CHANNEL_ID };
     }
     try {
       const accessToken = await getAccessToken(credentials.appId, credentials.clientSecret);
@@ -8830,12 +8853,12 @@ ${mediaUrl}` : mediaUrl;
         }
       }
       return {
-        channel: "qqbot",
+        channel: QQBOT_CHANNEL_ID,
         ...typingResult?.refIdx ? { refIdx: typingResult.refIdx } : {}
       };
     } catch (err) {
       const message = summarizeError(err);
-      return { channel: "qqbot", error: message };
+      return { channel: QQBOT_CHANNEL_ID, error: message };
     }
   }
 };
@@ -9283,7 +9306,7 @@ function clearKnownQQBotTargets(params = {}) {
 async function sendProactiveQQBotMessage(params) {
   const to = params.to.trim();
   if (!to) {
-    return { channel: "qqbot", error: "to is required for proactive send" };
+    return { channel: QQBOT_CHANNEL_ID, error: "to is required for proactive send" };
   }
   if (params.mediaUrl?.trim()) {
     return qqbotOutbound.sendMedia({
@@ -9296,7 +9319,7 @@ async function sendProactiveQQBotMessage(params) {
   }
   const text = params.text?.trim();
   if (!text) {
-    return { channel: "qqbot", error: "text or mediaUrl is required for proactive send" };
+    return { channel: QQBOT_CHANNEL_ID, error: "text or mediaUrl is required for proactive send" };
   }
   return qqbotOutbound.sendText({
     cfg: params.cfg,
@@ -9620,6 +9643,17 @@ var QQBOT_ABORT_TRIGGERS = /* @__PURE__ */ new Set([
   "stop please"
 ]);
 var QQBOT_ABORT_TRAILING_PUNCTUATION_RE = /[.!?…,，。;；:：'"’”)\]}]+$/u;
+var QQBOT_ROUTE_PREFIX_RE = new RegExp(
+  `^(agent:[^:]+:${QQBOT_CHANNEL_ID}:)(?:direct|dm):.+$`,
+  "i"
+);
+function buildQQBotScopedConfig(qqCfg) {
+  return {
+    channels: {
+      [QQBOT_CONFIG_CHANNEL_ID]: qqCfg
+    }
+  };
+}
 function resolveQQBotRouteSessionKey(route) {
   const effectiveSessionKey = route.effectiveSessionKey?.trim();
   if (effectiveSessionKey) {
@@ -9734,9 +9768,9 @@ function buildQQBotDirectSessionKey(params) {
   const normalizedSenderId = normalizeQQBotSessionKeyPart(params.senderStableId);
   const trimmedRouteSessionKey = params.routeSessionKey.trim();
   if (!trimmedRouteSessionKey) {
-    return `agent:main:qqbot:dm:${normalizedAccountId}:${normalizedSenderId}`;
+    return `agent:main:${QQBOT_CHANNEL_ID}:dm:${normalizedAccountId}:${normalizedSenderId}`;
   }
-  const qqAgentRouteMatch = trimmedRouteSessionKey.match(/^(agent:[^:]+:qqbot:)(?:direct|dm):.+$/i);
+  const qqAgentRouteMatch = trimmedRouteSessionKey.match(QQBOT_ROUTE_PREFIX_RE);
   if (qqAgentRouteMatch?.[1]) {
     return `${qqAgentRouteMatch[1]}dm:${normalizedAccountId}:${normalizedSenderId}`;
   }
@@ -9750,9 +9784,7 @@ function normalizeQQBotReplyTarget(value) {
   if (!trimmed) {
     return void 0;
   }
-  if (/^qqbot:/i.test(trimmed)) {
-    trimmed = trimmed.slice("qqbot:".length).trim();
-  }
+  trimmed = stripQQBotChannelPrefix(trimmed);
   if (/^c2c:/i.test(trimmed)) {
     const openid = trimmed.slice("c2c:".length).trim();
     return openid ? `user:${openid}` : void 0;
@@ -9861,7 +9893,7 @@ function normalizeQQBotDisplayAliasesMap(raw) {
   return aliases;
 }
 function resolveQQBotDisplayAliasMaps(cfg, accountId) {
-  const qqbot = cfg?.channels?.qqbot;
+  const qqbot = resolveQQBotChannelConfig(cfg);
   return {
     globalAliases: normalizeQQBotDisplayAliasesMap(qqbot?.displayAliases),
     accountAliases: normalizeQQBotDisplayAliasesMap(qqbot?.accounts?.[accountId]?.displayAliases)
@@ -10705,8 +10737,7 @@ function evaluateReplyFinalOnlyDelivery(params) {
   return { skipDelivery: true, suppressText: false };
 }
 function isQQBotC2CTarget(to) {
-  const trimmed = to.trim();
-  const raw = trimmed.slice(0, "qqbot:".length).toLowerCase() === "qqbot:" ? trimmed.slice("qqbot:".length) : trimmed;
+  const raw = stripQQBotChannelPrefix(to);
   const normalizedRaw = raw.toLowerCase();
   return !normalizedRaw.startsWith("group:") && !normalizedRaw.startsWith("channel:");
 }
@@ -11731,7 +11762,7 @@ async function sendQQBotMediaWithFallback(params) {
       return;
     }
     const result = await outbound.sendMedia({
-      cfg: { channels: { qqbot: qqCfg } },
+      cfg: buildQQBotScopedConfig(qqCfg),
       to,
       mediaUrl,
       replyToId,
@@ -11749,7 +11780,7 @@ async function sendQQBotMediaWithFallback(params) {
         return;
       }
       const fallbackResult = await outbound.sendText({
-        cfg: { channels: { qqbot: qqCfg } },
+        cfg: buildQQBotScopedConfig(qqCfg),
         to,
         text: fallback,
         replyToId,
@@ -11774,7 +11805,7 @@ function buildInboundContext(params) {
   const commandBody = params.commandBody ?? event.content;
   const chatType = event.type === "group" || event.type === "channel" ? "group" : "direct";
   const { to } = resolveChatTarget(event);
-  const from = event.type === "group" ? `qqbot:group:${event.groupOpenid ?? ""}` : event.type === "channel" ? `qqbot:channel:${event.channelId ?? ""}` : `qqbot:${event.senderId}`;
+  const from = event.type === "group" ? `${QQBOT_CHANNEL_ID}:group:${event.groupOpenid ?? ""}` : event.type === "channel" ? `${QQBOT_CHANNEL_ID}:channel:${event.channelId ?? ""}` : `${QQBOT_CHANNEL_ID}:${event.senderId}`;
   return {
     Body: body,
     RawBody: rawBody,
@@ -11787,12 +11818,12 @@ function buildInboundContext(params) {
     GroupSubject: event.type === "group" ? event.groupOpenid : event.channelId,
     SenderName: event.senderName,
     SenderId: event.senderId,
-    Provider: "qqbot",
+    Provider: QQBOT_CHANNEL_ID,
     MessageSid: event.messageId,
     Timestamp: event.timestamp,
     WasMentioned: event.mentionedBot,
     CommandAuthorized: true,
-    OriginatingChannel: "qqbot",
+    OriginatingChannel: QQBOT_CHANNEL_ID,
     OriginatingTo: to
   };
 }
@@ -11815,7 +11846,7 @@ async function dispatchToAgent(params) {
   let typingRefIdx;
   if (inbound.c2cOpenid && !isFastAbortCommand && !shouldSuppressVisibleReplies()) {
     const typing = await qqbotOutbound.sendTyping({
-      cfg: { channels: { qqbot: qqCfg } },
+      cfg: buildQQBotScopedConfig(qqCfg),
       to: `user:${inbound.c2cOpenid}`,
       replyToId: inbound.messageId,
       replyEventId: inbound.eventId,
@@ -11866,7 +11897,7 @@ async function dispatchToAgent(params) {
       renew: async () => {
         try {
           const typing = await qqbotOutbound.sendTyping({
-            cfg: { channels: { qqbot: qqCfg } },
+            cfg: buildQQBotScopedConfig(qqCfg),
             to: `user:${inbound.c2cOpenid}`,
             replyToId: inbound.messageId,
             replyEventId: inbound.eventId,
@@ -11886,7 +11917,7 @@ async function dispatchToAgent(params) {
       if (groupMessageInterfaceBlocked || isFastAbortCommand || shouldSuppressVisibleReplies()) return;
       markVisibleOutboundStarted();
       const result = await qqbotOutbound.sendText({
-        cfg: { channels: { qqbot: qqCfg } },
+        cfg: buildQQBotScopedConfig(qqCfg),
         to: target.to,
         text: LONG_TASK_NOTICE_TEXT,
         replyToId: inbound.messageId,
@@ -11923,7 +11954,7 @@ async function dispatchToAgent(params) {
       }
       markVisibleOutboundStarted();
       const fallback = await qqbotOutbound.sendText({
-        cfg: { channels: { qqbot: qqCfg } },
+        cfg: buildQQBotScopedConfig(qqCfg),
         to: target.to,
         text: buildVoiceASRFallbackReply(resolvedAttachmentResult.asrErrorMessage),
         replyToId: inbound.messageId,
@@ -12037,7 +12068,7 @@ async function dispatchToAgent(params) {
       const isGroup = inbound.type === "group" || inbound.type === "channel";
       const updateLastRoute = !isGroup ? {
         sessionKey: mainSessionKey ?? route.sessionKey,
-        channel: "qqbot",
+        channel: QQBOT_CHANNEL_ID,
         to: stableTo,
         accountId: outboundAccountId
       } : void 0;
@@ -12073,13 +12104,13 @@ async function dispatchToAgent(params) {
     const textApi = runtime2.channel?.text;
     const limit = textApi?.resolveTextChunkLimit?.({
       cfg,
-      channel: "qqbot",
+      channel: QQBOT_CHANNEL_ID,
       defaultLimit: qqCfg.textChunkLimit ?? 1500
     }) ?? (qqCfg.textChunkLimit ?? 1500);
-    const chunkMode = textApi?.resolveChunkMode?.(cfg, "qqbot");
+    const chunkMode = textApi?.resolveChunkMode?.(cfg, QQBOT_CHANNEL_ID);
     const tableMode = textApi?.resolveMarkdownTableMode?.({
       cfg,
-      channel: "qqbot",
+      channel: QQBOT_CHANNEL_ID,
       accountId: outboundAccountId
     });
     const resolvedTableMode = tableMode ?? "bullets";
@@ -12213,7 +12244,7 @@ async function dispatchToAgent(params) {
         );
         markVisibleOutboundStarted();
         const result = await qqbotOutbound.sendText({
-          cfg: { channels: { qqbot: qqCfg } },
+          cfg: buildQQBotScopedConfig(qqCfg),
           to: target.to,
           text: chunk,
           replyToId: textReplyRefs.replyToId,
@@ -12334,7 +12365,7 @@ async function dispatchToAgent(params) {
           }
           markVisibleOutboundStarted();
           const result = await qqbotOutbound.sendText({
-            cfg: { channels: { qqbot: qqCfg } },
+            cfg: buildQQBotScopedConfig(qqCfg),
             to: target.to,
             text: chunk,
             replyToId: textReplyRefs.replyToId,
@@ -12471,7 +12502,7 @@ async function dispatchToAgent(params) {
       logger.info("no visible reply generated for group mention; sending fallback text");
       markVisibleOutboundStarted();
       const fallbackResult = await qqbotOutbound.sendText({
-        cfg: { channels: { qqbot: qqCfg } },
+        cfg: buildQQBotScopedConfig(qqCfg),
         to: target.to,
         text: noReplyFallback,
         replyToId: inbound.messageId,
@@ -12599,7 +12630,7 @@ async function handleQQBotDispatch(params) {
   const target = resolveChatTarget(resolvedInbound);
   const route = routing({
     cfg: params.cfg,
-    channel: "qqbot",
+    channel: QQBOT_CHANNEL_ID,
     accountId,
     peer: { kind: target.peerKind, id: target.peerId }
   });
@@ -12965,7 +12996,7 @@ function stopQQBotMonitorForAccount(accountId = DEFAULT_ACCOUNT_ID) {
 
 // src/channel.ts
 var meta = {
-  id: "qqbot",
+  id: QQBOT_CHANNEL_ID,
   label: "QQ Bot",
   selectionLabel: "QQ Bot",
   docsPath: "/channels/qqbot",
@@ -12977,7 +13008,7 @@ var meta = {
 function resolveQQBotAccount(params) {
   const { cfg, accountId = DEFAULT_ACCOUNT_ID } = params;
   const merged = mergeQQBotAccountConfig(cfg, accountId);
-  const baseEnabled = cfg.channels?.qqbot?.enabled !== false;
+  const baseEnabled = resolveQQBotChannelConfig(cfg)?.enabled !== false;
   const enabled = baseEnabled && merged.enabled !== false;
   const credentials = resolveQQBotCredentials(merged);
   const configured = Boolean(credentials);
@@ -12993,7 +13024,7 @@ function resolveQQBotAccount(params) {
   };
 }
 var qqbotPlugin = {
-  id: "qqbot",
+  id: QQBOT_CHANNEL_ID,
   meta: {
     ...meta
   },
@@ -13012,10 +13043,7 @@ var qqbotPlugin = {
     normalizeTarget: (raw) => {
       const trimmed = raw.trim();
       if (!trimmed) return void 0;
-      let value = trimmed;
-      if (/^qqbot:/i.test(value)) {
-        value = value.slice("qqbot:".length);
-      }
+      let value = stripQQBotChannelPrefix(trimmed);
       if (/^(user|group|channel):/i.test(value)) {
         return value;
       }
@@ -13173,7 +13201,7 @@ var qqbotPlugin = {
       }
     }
   },
-  reload: { configPrefixes: ["channels.qqbot"] },
+  reload: { configPrefixes: [...QQBOT_CONFIG_PREFIXES] },
   onboarding: qqbotOnboardingAdapter,
   config: {
     listAccountIds: (cfg) => listQQBotAccountIds(cfg),
@@ -13181,58 +13209,41 @@ var qqbotPlugin = {
     defaultAccountId: () => DEFAULT_ACCOUNT_ID,
     setAccountEnabled: (params) => {
       const accountId = params.accountId ?? DEFAULT_ACCOUNT_ID;
-      const existing = params.cfg.channels?.qqbot ?? {};
+      const existing = resolveQQBotChannelConfig(params.cfg) ?? {};
       if (accountId === DEFAULT_ACCOUNT_ID) {
-        return {
-          ...params.cfg,
-          channels: {
-            ...params.cfg.channels,
-            qqbot: { ...existing, enabled: params.enabled }
-          }
-        };
+        return withQQBotChannelConfig(
+          params.cfg,
+          { ...existing, enabled: params.enabled }
+        );
       }
       const accounts = existing.accounts ?? {};
       const account = accounts[accountId] ?? {};
-      return {
-        ...params.cfg,
-        channels: {
-          ...params.cfg.channels,
-          qqbot: {
-            ...existing,
-            accounts: {
-              ...accounts,
-              [accountId]: { ...account, enabled: params.enabled }
-            }
+      return withQQBotChannelConfig(
+        params.cfg,
+        {
+          ...existing,
+          accounts: {
+            ...accounts,
+            [accountId]: { ...account, enabled: params.enabled }
           }
         }
-      };
+      );
     },
     deleteAccount: (params) => {
       const accountId = params.accountId ?? DEFAULT_ACCOUNT_ID;
       if (accountId === DEFAULT_ACCOUNT_ID) {
-        const next = { ...params.cfg };
-        const nextChannels = { ...params.cfg.channels };
-        delete nextChannels.qqbot;
-        if (Object.keys(nextChannels).length > 0) {
-          next.channels = nextChannels;
-        } else {
-          delete next.channels;
-        }
-        return next;
+        return withQQBotChannelConfig(params.cfg);
       }
-      const existing = params.cfg.channels?.qqbot;
+      const existing = resolveQQBotChannelConfig(params.cfg);
       if (!existing?.accounts?.[accountId]) return params.cfg;
       const { [accountId]: _removed, ...remainingAccounts } = existing.accounts;
-      return {
-        ...params.cfg,
-        channels: {
-          ...params.cfg.channels,
-          qqbot: {
-            ...existing,
-            accounts: Object.keys(remainingAccounts).length > 0 ? remainingAccounts : void 0
-          }
+      return withQQBotChannelConfig(
+        params.cfg,
+        {
+          ...existing,
+          accounts: Object.keys(remainingAccounts).length > 0 ? remainingAccounts : void 0
         }
-      };
+      );
     },
     isConfigured: (_account, cfg, accountId) => {
       const id = accountId ?? _account.accountId;
@@ -13253,11 +13264,11 @@ var qqbotPlugin = {
   },
   security: {
     collectWarnings: (params) => {
-      const qqCfg = params.cfg.channels?.qqbot;
+      const qqCfg = resolveQQBotChannelConfig(params.cfg);
       const groupPolicy = qqCfg?.groupPolicy ?? "allowlist";
       if (groupPolicy !== "open") return [];
       return [
-        `- QQ groups: groupPolicy="open" allows any member to trigger (mention-gated). Set channels.qqbot.groupPolicy="allowlist" + channels.qqbot.groupAllowFrom to restrict senders.`
+        `- QQ groups: groupPolicy="open" allows any member to trigger (mention-gated). Set channels.${QQBOT_CONFIG_CHANNEL_ID}.groupPolicy="allowlist" + channels.${QQBOT_CONFIG_CHANNEL_ID}.groupAllowFrom to restrict senders.`
       ];
     }
   },
@@ -13265,37 +13276,31 @@ var qqbotPlugin = {
     resolveAccountId: (params) => params.accountId ?? resolveDefaultQQBotAccountId(params.cfg),
     applyAccountConfig: (params) => {
       const accountId = params.accountId ?? DEFAULT_ACCOUNT_ID;
-      const existing = params.cfg.channels?.qqbot ?? {};
+      const existing = resolveQQBotChannelConfig(params.cfg) ?? {};
       if (accountId === DEFAULT_ACCOUNT_ID) {
-        return {
-          ...params.cfg,
-          channels: {
-            ...params.cfg.channels,
-            qqbot: { ...existing, ...params.config, enabled: true }
-          }
-        };
+        return withQQBotChannelConfig(
+          params.cfg,
+          { ...existing, ...params.config, enabled: true }
+        );
       }
       const accounts = existing.accounts ?? {};
-      return {
-        ...params.cfg,
-        channels: {
-          ...params.cfg.channels,
-          qqbot: {
-            ...existing,
-            accounts: {
-              ...accounts,
-              [accountId]: { ...accounts[accountId], ...params.config, enabled: true }
-            }
+      return withQQBotChannelConfig(
+        params.cfg,
+        {
+          ...existing,
+          accounts: {
+            ...accounts,
+            [accountId]: { ...accounts[accountId], ...params.config, enabled: true }
           }
         }
-      };
+      );
     }
   },
   outbound: qqbotOutbound,
   gateway: {
     startAccount: async (ctx) => {
       ctx.setStatus?.({ accountId: ctx.accountId });
-      ctx.log?.info(`[qqbot] starting gateway for account ${ctx.accountId}`);
+      ctx.log?.info(`[${QQBOT_CHANNEL_ID}] starting gateway for account ${ctx.accountId}`);
       if (ctx.runtime) {
         const candidate = ctx.runtime;
         const hasRouting = Boolean(candidate.channel?.routing?.resolveAgentRoute);
@@ -13324,7 +13329,7 @@ var qqbotPlugin = {
 
 // index.ts
 var plugin = {
-  id: "qqbot",
+  id: QQBOT_CHANNEL_ID,
   name: "QQ Bot",
   description: "QQ \u5F00\u653E\u5E73\u53F0\u673A\u5668\u4EBA\u6D88\u606F\u6E20\u9053\u63D2\u4EF6",
   configSchema: {
@@ -13442,7 +13447,7 @@ var plugin = {
     }
   },
   register(api) {
-    registerChinaSetupCli(api, { channels: ["qqbot"] });
+    registerChinaSetupCli(api, { channels: [QQBOT_CONFIG_CHANNEL_ID] });
     showChinaInstallHint(api);
     if (api.runtime) {
       setQQBotRuntime(api.runtime);
@@ -13452,6 +13457,6 @@ var plugin = {
 };
 var index_default = plugin;
 
-export { DEFAULT_ACCOUNT_ID, clearKnownQQBotTargets, index_default as default, getKnownQQBotTarget, getQQBotRuntime, listKnownQQBotTargets, qqbotPlugin, removeKnownQQBotTarget, sendProactiveQQBotMessage, setQQBotRuntime };
+export { DEFAULT_ACCOUNT_ID, QQBOT_CHANNEL_ID, QQBOT_CONFIG_CHANNEL_ID, clearKnownQQBotTargets, index_default as default, getKnownQQBotTarget, getQQBotRuntime, listKnownQQBotTargets, qqbotPlugin, removeKnownQQBotTarget, sendProactiveQQBotMessage, setQQBotRuntime };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map