@openclaw-china/shared 2026.3.29 → 2026.4.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw-china/shared",
-  "version": "2026.3.29",
+  "version": "2026.4.23",
   "type": "module",
   "exports": {
     ".": "./src/index.ts"

package/src/cli/china-setup.ts

@@ -51,7 +51,14 @@ type ConfigRoot = {
   [key: string]: unknown;
 };
 
-export type ChannelId = "dingtalk" | "feishu-china" | "wecom" | "wecom-app" | "wecom-kf" | "qqbot" | "wechat-mp";
+export type ChannelId =
+  | "dingtalk"
+  | "feishu-china"
+  | "wecom"
+  | "wecom-app"
+  | "wecom-kf"
+  | "qqbot-china"
+  | "wechat-mp";
 
 export type RegisterChinaSetupCliOptions = {
   channels?: readonly ChannelId[];
@@ -68,37 +75,38 @@ const GUIDES_BASE = "https://github.com/BytePioneer-AI/openclaw-china/tree/main/
 const OPENCLAW_HOME = join(homedir(), ".openclaw");
 const DEFAULT_PLUGIN_PATH = join(OPENCLAW_HOME, "extensions");
 const LEGACY_PLUGIN_PATH = join(OPENCLAW_HOME, "plugins");
-const CONFIG_FILE_PATH = join(OPENCLAW_HOME, "openclaw.json");
-const ANSI_RESET = "\u001b[0m";
-const ANSI_LINK = "\u001b[1;4;96m";
-const ANSI_BORDER = "\u001b[92m";
-const CHANNEL_ORDER: readonly ChannelId[] = [
-  "dingtalk",
-  "qqbot",
-  "wecom",
-  "wecom-app",
-  "wecom-kf",
+const CONFIG_FILE_PATH = join(OPENCLAW_HOME, "openclaw.json");
+const ANSI_RESET = "\u001b[0m";
+const ANSI_LINK = "\u001b[1;4;96m";
+const ANSI_BORDER = "\u001b[92m";
+const QQBOT_CHANNEL_ID = "qqbot-china" as const;
+const CHANNEL_ORDER: readonly ChannelId[] = [
+  "dingtalk",
+  QQBOT_CHANNEL_ID,
+  "wecom",
+  "wecom-app",
+  "wecom-kf",
   "wechat-mp",
   "feishu-china",
 ];
 const CHANNEL_DISPLAY_LABELS: Record<ChannelId, string> = {
   dingtalk: "DingTalk（钉钉）",
-  "feishu-china": "Feishu（飞书）",
-  wecom: "WeCom（企业微信-智能机器人）",
-  "wecom-app": "WeCom App（自建应用-可接入微信）",
-  "wecom-kf": "WeCom KF（微信客服）",
-  "wechat-mp": "WeChat MP（微信公众号）",
-  qqbot: "QQBot（QQ 机器人）",
-};
-const CHANNEL_GUIDE_LINKS: Record<ChannelId, string> = {
+  "feishu-china": "Feishu（飞书）",
+  wecom: "WeCom（企业微信-智能机器人）",
+  "wecom-app": "WeCom App（自建应用-可接入微信）",
+  "wecom-kf": "WeCom KF（微信客服）",
+  "wechat-mp": "WeChat MP（微信公众号）",
+  "qqbot-china": "QQBot（QQ 机器人）",
+};
+const CHANNEL_GUIDE_LINKS: Record<ChannelId, string> = {
   dingtalk: `${GUIDES_BASE}/dingtalk/configuration.md`,
   "feishu-china": "https://github.com/BytePioneer-AI/openclaw-china/blob/main/README.md",
   wecom: `${GUIDES_BASE}/wecom/configuration.md`,
-  "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`,
-};
+  "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-china": `${GUIDES_BASE}/qqbot/configuration.md`,
+};
 const CHINA_CLI_STATE_KEY = Symbol.for("@openclaw-china/china-cli-state");
 
 type ChinaCliState = {
@@ -272,11 +280,11 @@ function cloneConfig(cfg: ConfigRoot): ConfigRoot {
   }
 }
 
-function getChannelConfig(cfg: ConfigRoot, channelId: ChannelId): ConfigRecord {
-  const channels = isRecord(cfg.channels) ? cfg.channels : {};
-  const existing = channels[channelId];
-  return isRecord(existing) ? existing : {};
-}
+function getChannelConfig(cfg: ConfigRoot, channelId: ChannelId): ConfigRecord {
+  const channels = isRecord(cfg.channels) ? cfg.channels : {};
+  const existing = channels[channelId];
+  return isRecord(existing) ? existing : {};
+}
 
 function getGatewayAuthToken(cfg: ConfigRoot): string | undefined {
   if (!isRecord(cfg.gateway)) {
@@ -328,15 +336,15 @@ function hasWecomWsCredentialPair(channelCfg: ConfigRecord): boolean {
   return hasCredentialPair(channelCfg, "botId", "secret");
 }
 
-function isChannelConfigured(cfg: ConfigRoot, channelId: ChannelId): boolean {
-  const channelCfg = getChannelConfig(cfg, channelId);
-  switch (channelId) {
+function isChannelConfigured(cfg: ConfigRoot, channelId: ChannelId): boolean {
+  const channelCfg = getChannelConfig(cfg, channelId);
+  switch (channelId) {
     case "dingtalk":
       return hasNonEmptyString(channelCfg.clientId) && hasNonEmptyString(channelCfg.clientSecret);
     case "feishu-china":
       return hasNonEmptyString(channelCfg.appId) && hasNonEmptyString(channelCfg.appSecret);
-    case "qqbot":
-      return hasNonEmptyString(channelCfg.appId) && hasNonEmptyString(channelCfg.clientSecret);
+    case "qqbot-china":
+      return hasNonEmptyString(channelCfg.appId) && hasNonEmptyString(channelCfg.clientSecret);
     case "wecom":
       return hasWecomWsCredentialPair(channelCfg);
     case "wecom-app":
@@ -359,21 +367,22 @@ function withConfiguredSuffix(cfg: ConfigRoot, channelId: ChannelId): string {
   return isChannelConfigured(cfg, channelId) ? `${base}（已配置）` : base;
 }
 
-function mergeChannelConfig(
-  cfg: ConfigRoot,
-  channelId: ChannelId,
-  patch: ConfigRecord
-): ConfigRoot {
-  const channels = isRecord(cfg.channels) ? { ...cfg.channels } : {};
-  const existing = getChannelConfig(cfg, channelId);
-  channels[channelId] = {
-    ...existing,
-    ...patch,
-    enabled: true,
-  };
-  return {
-    ...cfg,
-    channels,
+function mergeChannelConfig(
+  cfg: ConfigRoot,
+  channelId: ChannelId,
+  patch: ConfigRecord
+): ConfigRoot {
+  const channels = isRecord(cfg.channels) ? { ...cfg.channels } : {};
+  const existing = getChannelConfig(cfg, channelId);
+  const nextChannelConfig = {
+    ...existing,
+    ...patch,
+    enabled: true,
+  };
+  channels[channelId] = nextChannelConfig;
+  return {
+    ...cfg,
+    channels,
   };
 }
 
@@ -795,10 +804,10 @@ async function configureWechatMp(prompter: SetupPrompter, cfg: ConfigRoot): Prom
   });
 }
 
-async function configureQQBot(prompter: SetupPrompter, cfg: ConfigRoot): Promise<ConfigRoot> {
-  section("配置 QQBot（QQ 机器人）");
-  showGuideLink("qqbot");
-  const existing = getChannelConfig(cfg, "qqbot");
+async function configureQQBot(prompter: SetupPrompter, cfg: ConfigRoot): Promise<ConfigRoot> {
+  section("配置 QQBot（QQ 机器人）");
+  showGuideLink(QQBOT_CHANNEL_ID);
+  const existing = getChannelConfig(cfg, QQBOT_CHANNEL_ID);
   const existingAsr = isRecord(existing.asr) ? existing.asr : {};
 
   const appId = await prompter.askText({
@@ -838,10 +847,10 @@ async function configureQQBot(prompter: SetupPrompter, cfg: ConfigRoot): Promise
     });
   }
 
-  return mergeChannelConfig(cfg, "qqbot", {
-    appId,
-    clientSecret,
-    asr,
+  return mergeChannelConfig(cfg, QQBOT_CHANNEL_ID, {
+    appId,
+    clientSecret,
+    asr,
   });
 }
 
@@ -863,8 +872,8 @@ async function configureSingleChannel(
       return configureWecomKf(prompter, cfg);
     case "wechat-mp":
       return configureWechatMp(prompter, cfg);
-    case "qqbot":
-      return configureQQBot(prompter, cfg);
+    case "qqbot-china":
+      return configureQQBot(prompter, cfg);
     default:
       return cfg;
   }

package/src/cli/install-hint.ts

@@ -18,16 +18,16 @@ const ANSI_RESET = "\u001b[0m";
 const ANSI_BOLD = "\u001b[1m";
 const ANSI_LINK = "\u001b[1;4;96m";
 const ANSI_BORDER = "\u001b[92m";
-const SUPPORTED_CHANNELS: readonly ChannelId[] = [
-  "dingtalk",
-  "feishu-china",
-  "wecom",
-  "wecom-app",
-  "wecom-kf",
-  "wechat-mp",
-  "qqbot",
-];
-const CHINA_INSTALL_HINT_SHOWN_KEY = Symbol.for("@openclaw-china/china-install-hint-shown");
+const SUPPORTED_CHANNELS: readonly ChannelId[] = [
+  "dingtalk",
+  "feishu-china",
+  "wecom",
+  "wecom-app",
+  "wecom-kf",
+  "wechat-mp",
+  "qqbot-china",
+];
+const CHINA_INSTALL_HINT_SHOWN_KEY = Symbol.for("@openclaw-china/china-install-hint-shown");
 
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -42,12 +42,12 @@ function hasAnyEnabledChinaChannel(config: unknown): boolean {
   if (!isRecord(channels)) {
     return false;
   }
-
-  return SUPPORTED_CHANNELS.some((channelId) => {
-    const channelConfig = channels[channelId];
-    return isRecord(channelConfig) && channelConfig.enabled === true;
-  });
-}
+
+  return SUPPORTED_CHANNELS.some((channelId) => {
+    const channelConfig = channels[channelId];
+    return isRecord(channelConfig) && channelConfig.enabled === true;
+  });
+}
 
 function hasShownInstallHint(): boolean {
   const root = globalThis as Record<PropertyKey, unknown>;

package/src/cron/index.ts

@@ -13,9 +13,9 @@ When creating or updating a cron task, always store a fixed delivery target in t
 - Do not include tool directives, "NO_REPLY", or heartbeat markers in payload.message.
 - Job name is never a message target.
 - During cron run, must return plain text only and never call the message tool.
-- Use top-level delivery with announce mode:
-  delivery.mode="announce"
-  delivery.channel=<OriginatingChannel> (example: "qqbot")
+- Use top-level delivery with announce mode:
+  delivery.mode="announce"
+  delivery.channel=<OriginatingChannel> (example: "qqbot")
   delivery.to=<OriginatingTo> (examples: "user:<openid>" / "group:<group_openid>")
   delivery.accountId=<AccountId> when available
 - Never set delivery.channel="last" for multi-channel environments.