ylib-wecom-openclaw-plugin 2026.4.29

package/dist/src/channel.js

@@ -0,0 +1,815 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __spreadArrays = (this && this.__spreadArrays) || function () {
+    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;
+    for (var r = Array(s), k = 0, i = 0; i < il; i++)
+        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)
+            r[k] = a[j];
+    return r;
+};
+exports.__esModule = true;
+exports.wecomPlugin = void 0;
+var openclaw_compat_js_1 = require("./openclaw-compat.js");
+var openclaw_compat_js_2 = require("./openclaw-compat.js");
+var runtime_js_1 = require("./runtime.js");
+var monitor_js_1 = require("./monitor.js");
+var state_manager_js_1 = require("./state-manager.js");
+var onboarding_js_1 = require("./onboarding.js");
+var accounts_js_1 = require("./accounts.js");
+var const_js_1 = require("./const.js");
+var media_uploader_js_1 = require("./media-uploader.js");
+var webhook_js_1 = require("./agent/webhook.js");
+var target_js_1 = require("./target.js");
+var api_client_js_1 = require("./agent/api-client.js");
+var index_js_1 = require("./webhook/index.js");
+var im_runtime_telemetry_js_1 = require("./im-runtime-telemetry.js");
+var markdown_chunk_js_1 = require("./markdown-chunk.js");
+var proactive_markdown_send_js_1 = require("./proactive-markdown-send.js");
+var WECOM_PROBE_CACHE_TTL_MS_DEFAULT = 10 * 60 * 1000;
+var WECOM_PROBE_CACHE_TTL_MS = Math.max(0, Number(process.env.WECOM_PROBE_CACHE_TTL_MS ||
+    String(WECOM_PROBE_CACHE_TTL_MS_DEFAULT)) || WECOM_PROBE_CACHE_TTL_MS_DEFAULT);
+var wecomProbeCacheByAccountId = new Map();
+function parseRuntimeBoolFlag(value) {
+    var normalized = String(value !== null && value !== void 0 ? value : "")
+        .trim()
+        .toLowerCase();
+    return (normalized === "1" ||
+        normalized === "true" ||
+        normalized === "yes" ||
+        normalized === "on");
+}
+function clearWeComProbeCache(accountId) {
+    var normalized = String(accountId || "").trim();
+    if (!normalized) {
+        wecomProbeCacheByAccountId.clear();
+        return;
+    }
+    wecomProbeCacheByAccountId["delete"](normalized);
+}
+function readWeComProbeCache(accountId, forceProbe) {
+    var _a;
+    if (forceProbe || WECOM_PROBE_CACHE_TTL_MS <= 0)
+        return null;
+    var normalized = String(accountId || "").trim();
+    if (!normalized)
+        return null;
+    var cache = wecomProbeCacheByAccountId.get(normalized);
+    if (!cache)
+        return null;
+    if (Date.now() - cache.updatedAtMs > WECOM_PROBE_CACHE_TTL_MS) {
+        wecomProbeCacheByAccountId["delete"](normalized);
+        return null;
+    }
+    return __assign(__assign({}, cache.result), { details: __assign(__assign({}, ((_a = cache.result.details) !== null && _a !== void 0 ? _a : {})), { cached: true, cacheUpdatedAtMs: cache.updatedAtMs }) });
+}
+function writeWeComProbeCache(accountId, result) {
+    var _a;
+    if (WECOM_PROBE_CACHE_TTL_MS <= 0)
+        return;
+    var normalized = String(accountId || "").trim();
+    if (!normalized)
+        return;
+    wecomProbeCacheByAccountId.set(normalized, {
+        result: __assign(__assign({}, result), { details: __assign(__assign({}, ((_a = result.details) !== null && _a !== void 0 ? _a : {})), { cached: false }) }),
+        updatedAtMs: Date.now()
+    });
+}
+/**
+ * 使用 SDK 的 sendMessage 主动发送企业微信消息
+ * 优先 Bot WebSocket，不可用时自动回退到 Agent HTTP API
+ */
+function sendWeComMessage(_a) {
+    var to = _a.to, content = _a.content, accountId = _a.accountId, cfg = _a.cfg;
+    return __awaiter(this, void 0, void 0, function () {
+        var resolvedAccountId, channelPrefix, chatId, wsClient, result, messageId, account, agent, target, outboundChunks, _i, outboundChunks_1, chunk;
+        return __generator(this, function (_b) {
+            switch (_b.label) {
+                case 0:
+                    resolvedAccountId = accountId !== null && accountId !== void 0 ? accountId : openclaw_compat_js_2.DEFAULT_ACCOUNT_ID;
+                    channelPrefix = new RegExp("^" + const_js_1.CHANNEL_ID + ":", "i");
+                    chatId = to.replace(channelPrefix, "");
+                    wsClient = state_manager_js_1.getWeComWebSocket(resolvedAccountId);
+                    if (!(wsClient === null || wsClient === void 0 ? void 0 : wsClient.isConnected)) return [3 /*break*/, 2];
+                    return [4 /*yield*/, proactive_markdown_send_js_1.sendWeComMarkdownMessageChunks({
+                            wsClient: wsClient,
+                            chatId: chatId,
+                            text: content,
+                            accountId: resolvedAccountId,
+                            label: "sendWeComMessage"
+                        })];
+                case 1:
+                    result = _b.sent();
+                    messageId = result.messageId;
+                    return [2 /*return*/, { channel: const_js_1.CHANNEL_ID, messageId: messageId, chatId: chatId }];
+                case 2:
+                    // ── 回退到 Agent HTTP API ──
+                    if (!cfg) {
+                        throw new Error("WSClient not connected for account " + resolvedAccountId + " and no config available for Agent fallback");
+                    }
+                    account = accounts_js_1.resolveWeComAccountMulti({ cfg: cfg, accountId: resolvedAccountId });
+                    agent = account.agent;
+                    if (!(agent === null || agent === void 0 ? void 0 : agent.configured)) {
+                        throw new Error("WSClient not connected for account " + resolvedAccountId + " and Agent mode is not configured. " +
+                            "Please configure either Bot (botId + secret) or Agent (corpId + corpSecret + agentId) for this account.");
+                    }
+                    target = target_js_1.resolveWecomTarget(chatId);
+                    if (!target) {
+                        throw new Error("Cannot resolve outbound target from \"" + to + "\"");
+                    }
+                    console.log("[wecom-outbound] Bot WS unavailable, sending via Agent HTTP API to " + JSON.stringify(target) + " (accountId=" + resolvedAccountId + ")");
+                    outboundChunks = markdown_chunk_js_1.splitMarkdownIntoSafeChunks(content || "当前没有可展示的回复内容", const_js_1.TEXT_CHUNK_LIMIT);
+                    _i = 0, outboundChunks_1 = outboundChunks;
+                    _b.label = 3;
+                case 3:
+                    if (!(_i < outboundChunks_1.length)) return [3 /*break*/, 6];
+                    chunk = outboundChunks_1[_i];
+                    return [4 /*yield*/, api_client_js_1.sendText({
+                            agent: agent,
+                            toUser: target.touser,
+                            toParty: target.toparty,
+                            toTag: target.totag,
+                            chatId: target.chatid,
+                            text: chunk
+                        })];
+                case 4:
+                    _b.sent();
+                    im_runtime_telemetry_js_1.imRuntimeRecordChannelActivity("wecom", resolvedAccountId, "outbound");
+                    _b.label = 5;
+                case 5:
+                    _i++;
+                    return [3 /*break*/, 3];
+                case 6: return [2 /*return*/, {
+                        channel: const_js_1.CHANNEL_ID,
+                        messageId: "agent-" + Date.now(),
+                        chatId: chatId
+                    }];
+            }
+        });
+    });
+}
+// 企业微信频道元数据
+var meta = {
+    id: const_js_1.CHANNEL_ID,
+    label: "企业微信",
+    selectionLabel: "企业微信 (WeCom)",
+    detailLabel: "企业微信智能机器人",
+    docsPath: "/channels/" + const_js_1.CHANNEL_ID,
+    docsLabel: const_js_1.CHANNEL_ID,
+    blurb: "企业微信智能机器人接入插件",
+    systemImage: "message.fill"
+};
+exports.wecomPlugin = {
+    id: const_js_1.CHANNEL_ID,
+    meta: __assign(__assign({}, meta), { quickstartAllowFrom: true }),
+    pairing: {
+        idLabel: "wecomUserId",
+        normalizeAllowEntry: function (entry) { return entry.replace(new RegExp("^(" + const_js_1.CHANNEL_ID + "|user):", "i"), "").trim(); },
+        notifyApproval: function (_a) {
+            var cfg = _a.cfg, id = _a.id;
+            return __awaiter(void 0, void 0, void 0, function () {
+                return __generator(this, function (_b) {
+                    return [2 /*return*/];
+                });
+            });
+        }
+    },
+    setupWizard: onboarding_js_1.wecomSetupWizard,
+    setup: onboarding_js_1.wecomSetupAdapter,
+    capabilities: {
+        chatTypes: ["direct", "group"],
+        reactions: false,
+        threads: false,
+        media: true,
+        nativeCommands: false,
+        blockStreaming: true
+    },
+    reload: { configPrefixes: ["channels." + const_js_1.CHANNEL_ID] },
+    config: {
+        // 多账号：列出所有账户 ID
+        listAccountIds: function (cfg) { return accounts_js_1.listWeComAccountIds(cfg); },
+        // 多账号：按 accountId 解析账户配置
+        resolveAccount: function (cfg, accountId) { return accounts_js_1.resolveWeComAccountMulti({ cfg: cfg, accountId: accountId }); },
+        // 多账号：获取默认账户 ID
+        defaultAccountId: function (cfg) { return accounts_js_1.resolveDefaultWeComAccountId(cfg); },
+        // 多账号：设置账户启用状态
+        setAccountEnabled: function (_a) {
+            var _b, _c, _d;
+            var _e, _f, _g, _h, _j;
+            var cfg = _a.cfg, accountId = _a.accountId, enabled = _a.enabled;
+            if (!accounts_js_1.hasMultiAccounts(cfg)) {
+                // 单账号模式：设置顶层 enabled
+                var wecomConfig_1 = ((_f = (_e = cfg.channels) === null || _e === void 0 ? void 0 : _e[const_js_1.CHANNEL_ID]) !== null && _f !== void 0 ? _f : {});
+                return __assign(__assign({}, cfg), { channels: __assign(__assign({}, cfg.channels), (_b = {}, _b[const_js_1.CHANNEL_ID] = __assign(__assign({}, wecomConfig_1), { enabled: enabled }), _b)) });
+            }
+            // 多账号模式：设置 accounts[accountId].enabled
+            var wecomConfig = ((_h = (_g = cfg.channels) === null || _g === void 0 ? void 0 : _g[const_js_1.CHANNEL_ID]) !== null && _h !== void 0 ? _h : {});
+            return __assign(__assign({}, cfg), { channels: __assign(__assign({}, cfg.channels), (_c = {}, _c[const_js_1.CHANNEL_ID] = __assign(__assign({}, wecomConfig), { accounts: __assign(__assign({}, wecomConfig.accounts), (_d = {}, _d[accountId] = __assign(__assign({}, (_j = wecomConfig.accounts) === null || _j === void 0 ? void 0 : _j[accountId]), { enabled: enabled }), _d)) }), _c)) });
+        },
+        // 多账号：删除账户
+        deleteAccount: function (_a) {
+            var _b;
+            var _c;
+            var cfg = _a.cfg, accountId = _a.accountId;
+            if (!accounts_js_1.hasMultiAccounts(cfg)) {
+                // 单账号模式：删除整个 wecom 配置
+                var next = __assign({}, cfg);
+                var nextChannels = __assign({}, cfg.channels);
+                delete nextChannels[const_js_1.CHANNEL_ID];
+                if (Object.keys(nextChannels).length > 0) {
+                    next.channels = nextChannels;
+                }
+                else {
+                    delete next.channels;
+                }
+                return next;
+            }
+            // 删除指定账号
+            var wecomConfig = (_c = cfg.channels) === null || _c === void 0 ? void 0 : _c[const_js_1.CHANNEL_ID];
+            var accounts = __assign({}, wecomConfig === null || wecomConfig === void 0 ? void 0 : wecomConfig.accounts);
+            delete accounts[accountId];
+            return __assign(__assign({}, cfg), { channels: __assign(__assign({}, cfg.channels), (_b = {}, _b[const_js_1.CHANNEL_ID] = __assign(__assign({}, wecomConfig), { accounts: Object.keys(accounts).length > 0 ? accounts : undefined }), _b)) });
+        },
+        // 检查是否已配置（Bot / Agent / botWebhook 凭证之一即可）
+        isConfigured: function (account) {
+            var _a, _b, _c, _d, _e;
+            return Boolean(((_a = account.botId) === null || _a === void 0 ? void 0 : _a.trim()) && ((_b = account.secret) === null || _b === void 0 ? void 0 : _b.trim())) ||
+                Boolean((_c = account.agent) === null || _c === void 0 ? void 0 : _c.configured) ||
+                Boolean(((_d = account.token) === null || _d === void 0 ? void 0 : _d.trim()) && ((_e = account.encodingAESKey) === null || _e === void 0 ? void 0 : _e.trim()));
+        },
+        // 描述账户信息
+        describeAccount: function (account) {
+            var _a, _b, _c, _d;
+            return ({
+                accountId: account.accountId,
+                name: account.name,
+                enabled: account.enabled,
+                configured: Boolean(((_a = account.botId) === null || _a === void 0 ? void 0 : _a.trim()) && ((_b = account.secret) === null || _b === void 0 ? void 0 : _b.trim())) || Boolean((_c = account.agent) === null || _c === void 0 ? void 0 : _c.configured),
+                botId: account.botId,
+                websocketUrl: account.websocketUrl,
+                agentConfigured: Boolean((_d = account.agent) === null || _d === void 0 ? void 0 : _d.configured)
+            });
+        },
+        // 解析允许来源列表（多账号：按 accountId 解析）
+        resolveAllowFrom: function (_a) {
+            var _b;
+            var cfg = _a.cfg, accountId = _a.accountId;
+            var account = accounts_js_1.resolveWeComAccountMulti({ cfg: cfg, accountId: accountId });
+            return ((_b = account.config.allowFrom) !== null && _b !== void 0 ? _b : []).map(function (entry) { return String(entry); });
+        },
+        // 格式化允许来源列表
+        formatAllowFrom: function (_a) {
+            var allowFrom = _a.allowFrom;
+            return allowFrom
+                .map(function (entry) { return String(entry).trim(); })
+                .filter(Boolean);
+        }
+    },
+    security: {
+        resolveDmPolicy: function (_a) {
+            var _b;
+            var cfg = _a.cfg, accountId = _a.accountId, account = _a.account;
+            var result = openclaw_compat_js_1.buildAccountScopedDmSecurityPolicy({
+                cfg: cfg,
+                channelKey: const_js_1.CHANNEL_ID,
+                accountId: accountId,
+                fallbackAccountId: account.accountId,
+                policy: account.config.dmPolicy,
+                allowFrom: (_b = account.config.allowFrom) !== null && _b !== void 0 ? _b : [],
+                defaultPolicy: "open",
+                policyPathSuffix: "dmPolicy",
+                approveHint: openclaw_compat_js_2.formatPairingApproveHint(const_js_1.CHANNEL_ID),
+                normalizeEntry: function (raw) { return raw.replace(new RegExp("^" + const_js_1.CHANNEL_ID + ":", "i"), "").trim(); }
+            });
+            return result;
+        },
+        collectWarnings: function (_a) {
+            var _b, _c, _d, _e, _f, _g;
+            var cfg = _a.cfg, accountId = _a.accountId;
+            var account = accounts_js_1.resolveWeComAccountMulti({ cfg: cfg, accountId: accountId });
+            var warnings = [];
+            // 动态构造配置路径（区分单账号 / 多账号）
+            var isMulti = accounts_js_1.hasMultiAccounts(cfg);
+            var basePath = isMulti && accountId
+                ? "channels." + const_js_1.CHANNEL_ID + ".accounts." + accountId + "."
+                : "channels." + const_js_1.CHANNEL_ID + ".";
+            // DM 策略警告
+            var dmPolicy = (_b = account.config.dmPolicy) !== null && _b !== void 0 ? _b : "open";
+            if (dmPolicy === "open") {
+                var hasWildcard = ((_c = account.config.allowFrom) !== null && _c !== void 0 ? _c : []).some(function (entry) { return String(entry).trim() === "*"; });
+                if (!hasWildcard) {
+                    warnings.push("- \u4F01\u4E1A\u5FAE\u4FE1[" + account.accountId + "]\u79C1\u4FE1\uFF1AdmPolicy=\"open\" \u4F46 allowFrom \u672A\u5305\u542B \"*\"\u3002\u4EFB\u4F55\u4EBA\u90FD\u53EF\u4EE5\u53D1\u6D88\u606F\uFF0C\u4F46\u5141\u8BB8\u5217\u8868\u4E3A\u7A7A\u53EF\u80FD\u5BFC\u81F4\u610F\u5916\u884C\u4E3A\u3002\u5EFA\u8BAE\u8BBE\u7F6E " + basePath + "allowFrom=[\"*\"] \u6216\u4F7F\u7528 dmPolicy=\"pairing\"\u3002");
+                }
+            }
+            // 群组策略警告
+            var defaultGroupPolicy = (_e = (_d = cfg.channels) === null || _d === void 0 ? void 0 : _d.defaults) === null || _e === void 0 ? void 0 : _e.groupPolicy;
+            var groupPolicy = (_g = (_f = account.config.groupPolicy) !== null && _f !== void 0 ? _f : defaultGroupPolicy) !== null && _g !== void 0 ? _g : "open";
+            if (groupPolicy === "open") {
+                warnings.push("- \u4F01\u4E1A\u5FAE\u4FE1[" + account.accountId + "]\u7FA4\u7EC4\uFF1AgroupPolicy=\"open\" \u5141\u8BB8\u6240\u6709\u7FA4\u7EC4\u4E2D\u7684\u6210\u5458\u89E6\u53D1\u3002\u8BBE\u7F6E " + basePath + "groupPolicy=\"allowlist\" + " + basePath + "groupAllowFrom \u6765\u9650\u5236\u7FA4\u7EC4\u3002");
+            }
+            return warnings;
+        }
+    },
+    messaging: {
+        normalizeTarget: function (target) {
+            var trimmed = target.trim();
+            if (!trimmed)
+                return undefined;
+            return trimmed;
+        },
+        targetResolver: {
+            looksLikeId: function (id) {
+                var trimmed = id === null || id === void 0 ? void 0 : id.trim();
+                return Boolean(trimmed);
+            },
+            hint: "<userId|groupId>"
+        }
+    },
+    directory: {
+        self: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+            return [2 /*return*/, null];
+        }); }); },
+        listPeers: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+            return [2 /*return*/, []];
+        }); }); },
+        listGroups: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+            return [2 /*return*/, []];
+        }); }); }
+    },
+    outbound: {
+        deliveryMode: "gateway",
+        chunker: function (text, limit) { return runtime_js_1.getWeComRuntime().channel.text.chunkMarkdownText(text, limit); },
+        textChunkLimit: const_js_1.TEXT_CHUNK_LIMIT,
+        sendText: function (_a) {
+            var to = _a.to, text = _a.text, accountId = _a.accountId, cfg = _a.cfg;
+            return __awaiter(void 0, void 0, void 0, function () {
+                return __generator(this, function (_b) {
+                    return [2 /*return*/, sendWeComMessage({ to: to, content: text, accountId: accountId !== null && accountId !== void 0 ? accountId : undefined, cfg: cfg })];
+                });
+            });
+        },
+        sendMedia: function (_a) {
+            var to = _a.to, text = _a.text, mediaUrl = _a.mediaUrl, mediaLocalRoots = _a.mediaLocalRoots, accountId = _a.accountId, cfg = _a.cfg;
+            return __awaiter(void 0, void 0, void 0, function () {
+                var resolvedAccountId, channelPrefix, chatId, resolvedAccount, wsClient, result, fallbackContent_1, account, agent, target, mediaResponse, buffer, _b, _c, filename, mediaId, err_1, fallbackContent;
+                var _d, _e;
+                return __generator(this, function (_f) {
+                    switch (_f.label) {
+                        case 0:
+                            resolvedAccountId = accountId !== null && accountId !== void 0 ? accountId : openclaw_compat_js_2.DEFAULT_ACCOUNT_ID;
+                            channelPrefix = new RegExp("^" + const_js_1.CHANNEL_ID + ":", "i");
+                            chatId = to.replace(channelPrefix, "");
+                            resolvedAccount = cfg
+                                ? accounts_js_1.resolveWeComAccountMulti({ cfg: cfg, accountId: resolvedAccountId })
+                                : undefined;
+                            // 如果没有 mediaUrl，fallback 为纯文本
+                            if (!mediaUrl) {
+                                return [2 /*return*/, sendWeComMessage({ to: to, content: text || "", accountId: resolvedAccountId, cfg: cfg })];
+                            }
+                            wsClient = state_manager_js_1.getWeComWebSocket(resolvedAccountId);
+                            if (!(wsClient === null || wsClient === void 0 ? void 0 : wsClient.isConnected)) return [3 /*break*/, 6];
+                            return [4 /*yield*/, media_uploader_js_1.uploadAndSendMedia({
+                                    wsClient: wsClient,
+                                    mediaUrl: mediaUrl,
+                                    chatId: chatId,
+                                    mediaLocalRoots: mediaLocalRoots,
+                                    gatewayToken: (_d = resolvedAccount === null || resolvedAccount === void 0 ? void 0 : resolvedAccount.config) === null || _d === void 0 ? void 0 : _d.gatewayToken,
+                                    gatewayBaseUrl: (_e = resolvedAccount === null || resolvedAccount === void 0 ? void 0 : resolvedAccount.config) === null || _e === void 0 ? void 0 : _e.gatewayBaseUrl
+                                })];
+                        case 1:
+                            result = _f.sent();
+                            if (result.rejected) {
+                                return [2 /*return*/, sendWeComMessage({ to: to, content: "\u26A0\uFE0F " + result.rejectReason, accountId: resolvedAccountId, cfg: cfg })];
+                            }
+                            if (!result.ok) {
+                                fallbackContent_1 = text
+                                    ? text + "\n\uD83D\uDCCE " + mediaUrl
+                                    : "\uD83D\uDCCE " + mediaUrl;
+                                return [2 /*return*/, sendWeComMessage({ to: to, content: fallbackContent_1, accountId: resolvedAccountId, cfg: cfg })];
+                            }
+                            im_runtime_telemetry_js_1.imRuntimeRecordChannelActivity("wecom", resolvedAccountId, "outbound");
+                            if (!text) return [3 /*break*/, 3];
+                            return [4 /*yield*/, sendWeComMessage({ to: to, content: text, accountId: resolvedAccountId, cfg: cfg })];
+                        case 2:
+                            _f.sent();
+                            _f.label = 3;
+                        case 3:
+                            if (!result.downgradeNote) return [3 /*break*/, 5];
+                            return [4 /*yield*/, sendWeComMessage({ to: to, content: "\u2139\uFE0F " + result.downgradeNote, accountId: resolvedAccountId, cfg: cfg })];
+                        case 4:
+                            _f.sent();
+                            _f.label = 5;
+                        case 5: return [2 /*return*/, {
+                                channel: const_js_1.CHANNEL_ID,
+                                messageId: result.messageId,
+                                chatId: chatId
+                            }];
+                        case 6:
+                            // ── 回退到 Agent HTTP API ──
+                            if (!cfg) {
+                                throw new Error("WSClient not connected for account " + resolvedAccountId + " and no config available for Agent fallback");
+                            }
+                            account = resolvedAccount !== null && resolvedAccount !== void 0 ? resolvedAccount : accounts_js_1.resolveWeComAccountMulti({ cfg: cfg, accountId: resolvedAccountId });
+                            agent = account.agent;
+                            if (!(agent === null || agent === void 0 ? void 0 : agent.configured)) {
+                                throw new Error("WSClient not connected for account " + resolvedAccountId + " and Agent mode is not configured. " +
+                                    "Please configure either Bot (botId + secret) or Agent (corpId + corpSecret + agentId).");
+                            }
+                            target = target_js_1.resolveWecomTarget(chatId);
+                            if (!target) {
+                                throw new Error("Cannot resolve outbound target from \"" + to + "\"");
+                            }
+                            console.log("[wecom-outbound] Bot WS unavailable, sending media via Agent HTTP API to " + JSON.stringify(target));
+                            _f.label = 7;
+                        case 7:
+                            _f.trys.push([7, 15, , 16]);
+                            return [4 /*yield*/, fetch(mediaUrl)];
+                        case 8:
+                            mediaResponse = _f.sent();
+                            if (!mediaResponse.ok) return [3 /*break*/, 14];
+                            _c = (_b = Buffer).from;
+                            return [4 /*yield*/, mediaResponse.arrayBuffer()];
+                        case 9:
+                            buffer = _c.apply(_b, [_f.sent()]);
+                            filename = mediaUrl.split('/').pop() || 'file.bin';
+                            return [4 /*yield*/, api_client_js_1.uploadMedia({
+                                    agent: agent,
+                                    type: 'file',
+                                    buffer: buffer,
+                                    filename: filename
+                                })];
+                        case 10:
+                            mediaId = _f.sent();
+                            return [4 /*yield*/, api_client_js_1.sendMedia({
+                                    agent: agent,
+                                    toUser: target.touser,
+                                    toParty: target.toparty,
+                                    toTag: target.totag,
+                                    chatId: target.chatid,
+                                    mediaId: mediaId,
+                                    mediaType: 'file'
+                                })];
+                        case 11:
+                            _f.sent();
+                            im_runtime_telemetry_js_1.imRuntimeRecordChannelActivity("wecom", resolvedAccountId, "outbound");
+                            if (!text) return [3 /*break*/, 13];
+                            return [4 /*yield*/, api_client_js_1.sendText({ agent: agent, toUser: target.touser, toParty: target.toparty, toTag: target.totag, chatId: target.chatid, text: text })];
+                        case 12:
+                            _f.sent();
+                            im_runtime_telemetry_js_1.imRuntimeRecordChannelActivity("wecom", resolvedAccountId, "outbound");
+                            _f.label = 13;
+                        case 13: return [2 /*return*/, { channel: const_js_1.CHANNEL_ID, messageId: "agent-media-" + Date.now(), chatId: chatId }];
+                        case 14: return [3 /*break*/, 16];
+                        case 15:
+                            err_1 = _f.sent();
+                            console.warn("[wecom-outbound] Agent media upload failed, falling back to text:", err_1);
+                            return [3 /*break*/, 16];
+                        case 16:
+                            fallbackContent = text ? text + "\n\uD83D\uDCCE " + mediaUrl : "\uD83D\uDCCE " + mediaUrl;
+                            return [4 /*yield*/, api_client_js_1.sendText({ agent: agent, toUser: target.touser, toParty: target.toparty, toTag: target.totag, chatId: target.chatid, text: fallbackContent })];
+                        case 17:
+                            _f.sent();
+                            im_runtime_telemetry_js_1.imRuntimeRecordChannelActivity("wecom", resolvedAccountId, "outbound");
+                            return [2 /*return*/, { channel: const_js_1.CHANNEL_ID, messageId: "agent-" + Date.now(), chatId: chatId }];
+                    }
+                });
+            });
+        }
+    },
+    status: {
+        defaultRuntime: {
+            accountId: openclaw_compat_js_2.DEFAULT_ACCOUNT_ID,
+            running: false,
+            lastStartAt: null,
+            lastStopAt: null,
+            lastError: null
+        },
+        collectStatusIssues: function (accounts) {
+            return accounts.flatMap(function (entry) {
+                var _a;
+                var accountId = String((_a = entry.accountId) !== null && _a !== void 0 ? _a : openclaw_compat_js_2.DEFAULT_ACCOUNT_ID);
+                var enabled = entry.enabled !== false;
+                var configured = entry.configured === true;
+                if (!enabled) {
+                    return [];
+                }
+                var issues = [];
+                if (!configured) {
+                    issues.push({
+                        channel: const_js_1.CHANNEL_ID,
+                        accountId: accountId,
+                        kind: "config",
+                        message: "企业微信机器人 ID 或 Secret 未配置",
+                        fix: "Run: openclaw channels add wecom --bot-id <id> --secret <secret>"
+                    });
+                }
+                return issues;
+            });
+        },
+        buildChannelSummary: function (_a) {
+            var _b, _c, _d, _e, _f;
+            var snapshot = _a.snapshot;
+            return ({
+                configured: (_b = snapshot.configured) !== null && _b !== void 0 ? _b : false,
+                running: (_c = snapshot.running) !== null && _c !== void 0 ? _c : false,
+                lastStartAt: (_d = snapshot.lastStartAt) !== null && _d !== void 0 ? _d : null,
+                lastStopAt: (_e = snapshot.lastStopAt) !== null && _e !== void 0 ? _e : null,
+                lastError: (_f = snapshot.lastError) !== null && _f !== void 0 ? _f : null
+            });
+        },
+        probeAccount: function (_a) {
+            var account = _a.account, forceProbe = _a.forceProbe, force_probe = _a.force_probe;
+            return __awaiter(void 0, void 0, void 0, function () {
+                var accountId, shouldForceProbe, configured, result_1, cached, wsClient, snapshot, connected, result_2, result;
+                var _b, _c;
+                return __generator(this, function (_d) {
+                    accountId = String((account === null || account === void 0 ? void 0 : account.accountId) || openclaw_compat_js_2.DEFAULT_ACCOUNT_ID).trim();
+                    shouldForceProbe = parseRuntimeBoolFlag(forceProbe != null ? forceProbe : force_probe);
+                    configured = Boolean(((_b = account === null || account === void 0 ? void 0 : account.botId) === null || _b === void 0 ? void 0 : _b.trim()) && ((_c = account === null || account === void 0 ? void 0 : account.secret) === null || _c === void 0 ? void 0 : _c.trim()));
+                    if (!configured) {
+                        result_1 = {
+                            ok: false,
+                            error: "wecom websocket account not configured",
+                            details: { accountId: accountId, source: "wecom_plugin_probe" }
+                        };
+                        writeWeComProbeCache(accountId, result_1);
+                        return [2 /*return*/, result_1];
+                    }
+                    cached = readWeComProbeCache(accountId, shouldForceProbe);
+                    if (cached) {
+                        return [2 /*return*/, cached];
+                    }
+                    wsClient = state_manager_js_1.getWeComWebSocket(accountId);
+                    snapshot = state_manager_js_1.getWeComConnectionSnapshot(accountId);
+                    connected = Boolean((wsClient === null || wsClient === void 0 ? void 0 : wsClient.isConnected) || ((snapshot === null || snapshot === void 0 ? void 0 : snapshot.connected) && (snapshot === null || snapshot === void 0 ? void 0 : snapshot.authenticated)));
+                    if (!connected) {
+                        result_2 = {
+                            ok: false,
+                            error: (snapshot === null || snapshot === void 0 ? void 0 : snapshot.lastError) || "wecom websocket not connected",
+                            details: {
+                                accountId: accountId,
+                                source: "wecom_plugin_probe",
+                                forceProbe: shouldForceProbe,
+                                wsConnected: Boolean(wsClient === null || wsClient === void 0 ? void 0 : wsClient.isConnected),
+                                snapshot: snapshot
+                            }
+                        };
+                        writeWeComProbeCache(accountId, result_2);
+                        return [2 /*return*/, result_2];
+                    }
+                    result = {
+                        ok: true,
+                        status: 200,
+                        details: {
+                            accountId: accountId,
+                            source: "wecom_plugin_probe",
+                            forceProbe: shouldForceProbe,
+                            wsConnected: Boolean(wsClient === null || wsClient === void 0 ? void 0 : wsClient.isConnected),
+                            snapshot: snapshot
+                        }
+                    };
+                    writeWeComProbeCache(accountId, result);
+                    return [2 /*return*/, result];
+                });
+            });
+        },
+        buildAccountSnapshot: function (_a) {
+            var _b, _c, _d, _e, _f, _g, _h;
+            var account = _a.account, runtime = _a.runtime;
+            var configured = Boolean(((_b = account.botId) === null || _b === void 0 ? void 0 : _b.trim()) && ((_c = account.secret) === null || _c === void 0 ? void 0 : _c.trim())) || Boolean((_d = account.agent) === null || _d === void 0 ? void 0 : _d.configured);
+            return {
+                accountId: account.accountId,
+                name: account.name,
+                enabled: account.enabled,
+                configured: configured,
+                running: (_e = runtime === null || runtime === void 0 ? void 0 : runtime.running) !== null && _e !== void 0 ? _e : false,
+                lastStartAt: (_f = runtime === null || runtime === void 0 ? void 0 : runtime.lastStartAt) !== null && _f !== void 0 ? _f : null,
+                lastStopAt: (_g = runtime === null || runtime === void 0 ? void 0 : runtime.lastStopAt) !== null && _g !== void 0 ? _g : null,
+                lastError: (_h = runtime === null || runtime === void 0 ? void 0 : runtime.lastError) !== null && _h !== void 0 ? _h : null
+            };
+        }
+    },
+    gateway: {
+        startAccount: function (ctx) { return __awaiter(void 0, void 0, void 0, function () {
+            var account, connectionMode, agent, isMulti, defaultId, isDefault, paths, _i, paths_1, p, hasBotCredentials, webhookAccount, gatewayCtx_1;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            return __generator(this, function (_l) {
+                switch (_l.label) {
+                    case 0:
+                        account = accounts_js_1.resolveWeComAccountMulti({ cfg: ctx.cfg, accountId: ctx.accountId });
+                        connectionMode = (_a = account.config.connectionMode) !== null && _a !== void 0 ? _a : "websocket";
+                        (_b = ctx.log) === null || _b === void 0 ? void 0 : _b.info("starting wecom[" + ctx.accountId + "] (name: " + account.name + ", mode: " + connectionMode + ")");
+                        clearWeComProbeCache(ctx.accountId);
+                        agent = account.agent;
+                        if (agent === null || agent === void 0 ? void 0 : agent.configured) {
+                            isMulti = accounts_js_1.hasMultiAccounts(ctx.cfg);
+                            defaultId = accounts_js_1.resolveDefaultWeComAccountId(ctx.cfg);
+                            isDefault = ctx.accountId === defaultId;
+                            paths = isMulti
+                                ? __spreadArrays([
+                                    const_js_1.WEBHOOK_PATHS.AGENT_PLUGIN + "/" + ctx.accountId,
+                                    const_js_1.WEBHOOK_PATHS.AGENT + "/" + ctx.accountId
+                                ], (isDefault && ctx.accountId !== openclaw_compat_js_2.DEFAULT_ACCOUNT_ID
+                                    ? [
+                                        const_js_1.WEBHOOK_PATHS.AGENT_PLUGIN + "/" + openclaw_compat_js_2.DEFAULT_ACCOUNT_ID,
+                                        const_js_1.WEBHOOK_PATHS.AGENT + "/" + openclaw_compat_js_2.DEFAULT_ACCOUNT_ID,
+                                    ]
+                                    : []), [
+                                    const_js_1.WEBHOOK_PATHS.AGENT_PLUGIN,
+                                    const_js_1.WEBHOOK_PATHS.AGENT,
+                                ]) : [
+                                // 单账号模式：同时注册 /default 路径以支持显式指定
+                                const_js_1.WEBHOOK_PATHS.AGENT_PLUGIN,
+                                const_js_1.WEBHOOK_PATHS.AGENT,
+                                const_js_1.WEBHOOK_PATHS.AGENT_PLUGIN + "/" + openclaw_compat_js_2.DEFAULT_ACCOUNT_ID,
+                                const_js_1.WEBHOOK_PATHS.AGENT + "/" + openclaw_compat_js_2.DEFAULT_ACCOUNT_ID,
+                            ];
+                            for (_i = 0, paths_1 = paths; _i < paths_1.length; _i++) {
+                                p = paths_1[_i];
+                                webhook_js_1.registerAgentWebhookTarget({
+                                    agent: agent,
+                                    config: ctx.cfg,
+                                    runtime: {
+                                        log: ((_c = ctx.log) === null || _c === void 0 ? void 0 : _c.info) ? function (msg) { return ctx.log.info(msg); } : undefined,
+                                        error: ((_d = ctx.log) === null || _d === void 0 ? void 0 : _d.error) ? function (msg) { return ctx.log.error(msg); } : undefined
+                                    },
+                                    path: p
+                                });
+                            }
+                            (_e = ctx.log) === null || _e === void 0 ? void 0 : _e.info("[" + ctx.accountId + "] wecom agent webhook registered at " + paths.join(", "));
+                            // 账号生命周期结束时清理
+                            ctx.abortSignal.addEventListener("abort", function () {
+                                webhook_js_1.deregisterAgentWebhookTarget(agent.accountId);
+                            }, { once: true });
+                        }
+                        hasBotCredentials = Boolean(((_f = account.botId) === null || _f === void 0 ? void 0 : _f.trim()) && ((_g = account.secret) === null || _g === void 0 ? void 0 : _g.trim()));
+                        if (!hasBotCredentials) return [3 /*break*/, 1];
+                        return [2 /*return*/, monitor_js_1.monitorWeComProvider({
+                                account: account,
+                                config: ctx.cfg,
+                                runtime: ctx.runtime,
+                                abortSignal: ctx.abortSignal,
+                                // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- SDK 类型签名在不同版本间存在差异
+                                setStatus: ctx.setStatus
+                            })];
+                    case 1:
+                        if (!(connectionMode === "webhook")) return [3 /*break*/, 3];
+                        webhookAccount = __assign(__assign({}, account), { connectionMode: "webhook", token: (_h = account.config.token) !== null && _h !== void 0 ? _h : "", encodingAESKey: (_j = account.config.encodingAESKey) !== null && _j !== void 0 ? _j : "", receiveId: (_k = account.config.receiveId) !== null && _k !== void 0 ? _k : "", welcomeText: account.config.welcomeText });
+                        gatewayCtx_1 = {
+                            account: webhookAccount,
+                            config: ctx.cfg,
+                            runtime: ctx.runtime,
+                            abortSignal: ctx.abortSignal,
+                            setStatus: ctx.setStatus,
+                            log: ctx.log,
+                            accountId: ctx.accountId
+                        };
+                        index_js_1.startWebhookGateway(gatewayCtx_1);
+                        // 等待 abortSignal 停止后清理
+                        return [4 /*yield*/, new Promise(function (resolve) {
+                                if (ctx.abortSignal.aborted) {
+                                    clearWeComProbeCache(ctx.accountId);
+                                    index_js_1.stopWebhookGateway(gatewayCtx_1);
+                                    resolve();
+                                    return;
+                                }
+                                ctx.abortSignal.addEventListener("abort", function () {
+                                    clearWeComProbeCache(ctx.accountId);
+                                    index_js_1.stopWebhookGateway(gatewayCtx_1);
+                                    resolve();
+                                }, { once: true });
+                            })];
+                    case 2:
+                        // 等待 abortSignal 停止后清理
+                        _l.sent();
+                        return [2 /*return*/];
+                    case 3: 
+                    // Agent-only：无 Bot，等待 abort 信号
+                    return [2 /*return*/, new Promise(function (resolve) {
+                            ctx.abortSignal.addEventListener("abort", function () {
+                                clearWeComProbeCache(ctx.accountId);
+                                resolve();
+                            }, { once: true });
+                        })];
+                }
+            });
+        }); },
+        logoutAccount: function (_a) {
+            var cfg = _a.cfg, accountId = _a.accountId;
+            return __awaiter(void 0, void 0, void 0, function () {
+                var resolvedAccountId, isMulti, nextCfg, cleared, changed, wecomConfig, nextWecom, nextChannels, wecomConfig, accountCfg, nextAccount, nextAccounts, resolved, loggedOut;
+                var _b, _c;
+                var _d, _e, _f, _g, _h;
+                return __generator(this, function (_j) {
+                    switch (_j.label) {
+                        case 0:
+                            resolvedAccountId = accountId !== null && accountId !== void 0 ? accountId : openclaw_compat_js_2.DEFAULT_ACCOUNT_ID;
+                            clearWeComProbeCache(resolvedAccountId);
+                            isMulti = accounts_js_1.hasMultiAccounts(cfg);
+                            nextCfg = __assign({}, cfg);
+                            cleared = false;
+                            changed = false;
+                            if (!isMulti) {
+                                wecomConfig = ((_e = (_d = cfg.channels) === null || _d === void 0 ? void 0 : _d[const_js_1.CHANNEL_ID]) !== null && _e !== void 0 ? _e : {});
+                                nextWecom = __assign({}, wecomConfig);
+                                if (nextWecom.botId || nextWecom.secret) {
+                                    delete nextWecom.botId;
+                                    delete nextWecom.secret;
+                                    cleared = true;
+                                    changed = true;
+                                }
+                                if (changed) {
+                                    if (Object.keys(nextWecom).length > 0) {
+                                        nextCfg.channels = __assign(__assign({}, nextCfg.channels), (_b = {}, _b[const_js_1.CHANNEL_ID] = nextWecom, _b));
+                                    }
+                                    else {
+                                        nextChannels = __assign({}, nextCfg.channels);
+                                        delete nextChannels[const_js_1.CHANNEL_ID];
+                                        if (Object.keys(nextChannels).length > 0) {
+                                            nextCfg.channels = nextChannels;
+                                        }
+                                        else {
+                                            delete nextCfg.channels;
+                                        }
+                                    }
+                                }
+                            }
+                            else {
+                                wecomConfig = ((_g = (_f = cfg.channels) === null || _f === void 0 ? void 0 : _f[const_js_1.CHANNEL_ID]) !== null && _g !== void 0 ? _g : {});
+                                accountCfg = (_h = wecomConfig.accounts) === null || _h === void 0 ? void 0 : _h[resolvedAccountId];
+                                if ((accountCfg === null || accountCfg === void 0 ? void 0 : accountCfg.botId) || (accountCfg === null || accountCfg === void 0 ? void 0 : accountCfg.secret)) {
+                                    nextAccount = __assign({}, accountCfg);
+                                    delete nextAccount.botId;
+                                    delete nextAccount.secret;
+                                    cleared = true;
+                                    changed = true;
+                                    nextAccounts = __assign({}, wecomConfig.accounts);
+                                    if (Object.keys(nextAccount).length > 0) {
+                                        nextAccounts[resolvedAccountId] = nextAccount;
+                                    }
+                                    else {
+                                        delete nextAccounts[resolvedAccountId];
+                                    }
+                                    nextCfg = __assign(__assign({}, cfg), { channels: __assign(__assign({}, cfg.channels), (_c = {}, _c[const_js_1.CHANNEL_ID] = __assign(__assign({}, wecomConfig), { accounts: Object.keys(nextAccounts).length > 0 ? nextAccounts : undefined }), _c)) });
+                                }
+                            }
+                            if (!changed) return [3 /*break*/, 2];
+                            return [4 /*yield*/, runtime_js_1.getWeComRuntime().config.writeConfigFile(nextCfg)];
+                        case 1:
+                            _j.sent();
+                            _j.label = 2;
+                        case 2:
+                            resolved = accounts_js_1.resolveWeComAccountMulti({ cfg: changed ? nextCfg : cfg, accountId: resolvedAccountId });
+                            loggedOut = !resolved.botId && !resolved.secret;
+                            return [2 /*return*/, { cleared: cleared, envToken: false, loggedOut: loggedOut }];
+                    }
+                });
+            });
+        }
+    }
+};