@openclaw-china/wecom 2026.3.22 → 2026.4.23

package/dist/index.d.ts

@@ -103,6 +103,13 @@ interface PluginConfig {
     };
 }
 
+type WecomMessageActionName = "send" | "sendAttachment";
+interface WecomMessageToolResult {
+    ok: boolean;
+    messageId?: string;
+    error?: string;
+    [key: string]: unknown;
+}
 declare const wecomPlugin: {
     id: string;
     meta: {
@@ -463,6 +470,25 @@ declare const wecomPlugin: {
             setStatus?: (status: Record<string, unknown>) => void;
         }) => Promise<void>;
     };
+    actions: {
+        describeMessageTool: () => {
+            actions: WecomMessageActionName[];
+            capabilities: string[];
+            schema?: {
+                properties: Record<string, unknown>;
+                visibility?: "current-channel" | "all-configured";
+            };
+        };
+        handleAction: (ctx: {
+            channel: string;
+            action: string;
+            params: Record<string, unknown>;
+            cfg: PluginConfig;
+            accountId?: string | null;
+            sessionKey?: string | null;
+            sessionId?: string | null;
+        }) => Promise<WecomMessageToolResult>;
+    };
 };
 
 /**

package/dist/index.js

@@ -1723,9 +1723,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_ID = "qqbot-china";
 var CHANNEL_ORDER = [
   "dingtalk",
-  "qqbot",
+  QQBOT_CHANNEL_ID,
   "wecom",
   "wecom-app",
   "wecom-kf",
@@ -1739,7 +1740,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`,
@@ -1748,7 +1749,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 {
@@ -1950,7 +1951,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);
@@ -1971,11 +1972,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
@@ -2352,8 +2354,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_ID);
+  const existing = getChannelConfig(cfg, QQBOT_CHANNEL_ID);
   const existingAsr = isRecord(existing.asr) ? existing.asr : {};
   const appId = await prompter.askText({
     label: "QQBot appId",
@@ -2390,7 +2392,7 @@ async function configureQQBot(prompter, cfg) {
       required: true
     });
   }
-  return mergeChannelConfig(cfg, "qqbot", {
+  return mergeChannelConfig(cfg, QQBOT_CHANNEL_ID, {
     appId,
     clientSecret,
     asr
@@ -2410,7 +2412,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;
@@ -2552,7 +2554,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) {
@@ -10178,6 +10180,91 @@ function stopWecomWsGatewayForAccount(accountId) {
 }
 
 // src/channel.ts
+function readStringParam(params, name, opts) {
+  const value = params[name];
+  if (value === void 0 || value === null) {
+    if (opts?.required) {
+      throw new Error(`wecom ${name} param is required`);
+    }
+    return void 0;
+  }
+  const str = String(value);
+  return opts?.trim ? str.trim() : str;
+}
+async function handleWecomMessageAction(ctx, outbound) {
+  const { action, params, cfg, accountId, sessionKey, sessionId } = ctx;
+  const commonParams = {
+    cfg,
+    accountId: accountId ?? void 0,
+    sessionKey: sessionKey ?? void 0,
+    runId: sessionId ?? void 0
+  };
+  if (action === "send") {
+    const to = readStringParam(params, "to", { required: true });
+    const message = readStringParam(params, "message", { required: false, trim: true }) ?? "";
+    const media = readStringParam(params, "media", { trim: false });
+    if (!to) {
+      return { ok: false, error: "wecom send requires 'to' param" };
+    }
+    if (media) {
+      const result = await outbound.sendMedia({
+        ...commonParams,
+        to,
+        mediaUrl: media,
+        text: message || void 0
+      });
+      if (!result.ok) {
+        return { ok: false, error: result.error?.message ?? "sendMedia failed" };
+      }
+      return { ok: true, messageId: result.messageId };
+    } else {
+      const result = await outbound.sendText({
+        ...commonParams,
+        to,
+        text: message
+      });
+      if (!result.ok) {
+        return { ok: false, error: result.error?.message ?? "sendText failed" };
+      }
+      return { ok: true, messageId: result.messageId };
+    }
+  }
+  if (action === "sendAttachment") {
+    const to = readStringParam(params, "to", { required: true });
+    const media = readStringParam(params, "media", { trim: false });
+    const caption = readStringParam(params, "caption", { required: false, trim: true });
+    if (!to) {
+      return { ok: false, error: "wecom sendAttachment requires 'to' param" };
+    }
+    if (!media) {
+      return { ok: false, error: "wecom sendAttachment requires 'media' param" };
+    }
+    const result = await outbound.sendMedia({
+      ...commonParams,
+      to,
+      mediaUrl: media,
+      text: caption
+    });
+    if (!result.ok) {
+      return { ok: false, error: result.error?.message ?? "sendMedia failed" };
+    }
+    return { ok: true, messageId: result.messageId };
+  }
+  return { ok: false, error: `Unsupported wecom action: ${action}` };
+}
+function describeWecomMessageTool() {
+  return {
+    actions: ["send", "sendAttachment"],
+    capabilities: ["media"],
+    schema: {
+      properties: {
+        media: { type: "string", description: "Media file URL or local file path (for file/image/audio/video attachments)" },
+        caption: { type: "string", description: "Optional caption text for the media" }
+      },
+      visibility: "current-channel"
+    }
+  };
+}
 var BARE_USER_ID_RE = /^[a-z0-9][a-z0-9._@-]{0,63}$/;
 var EXPLICIT_USER_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._@-]{0,63}$/;
 var GROUP_ID_RE = /^[A-Za-z0-9][A-Za-z0-9._:@-]{0,127}$/;
@@ -10932,6 +11019,10 @@ var wecomPlugin = {
       stopWecomWsGatewayForAccount(ctx.accountId);
       ctx.setStatus?.({ accountId: ctx.accountId, running: false, lastStopAt: Date.now() });
     }
+  },
+  actions: {
+    describeMessageTool: () => describeWecomMessageTool(),
+    handleAction: async (ctx) => handleWecomMessageAction(ctx, wecomPlugin.outbound)
   }
 };