@wecom/wecom-openclaw-plugin 2026.3.30 → 2026.3.31-beta.1

package/dist/src/const.d.ts

@@ -70,5 +70,51 @@ export declare const EVENT_ENTER_CHECK_UPDATE = "event.enter_check_update";
 export declare const CMD_ENTER_EVENT_REPLY = "ww_ai_robot_enter_event";
 /** WSClient scene 参数：企微 OpenClaw 场景 */
 export declare const SCENE_WECOM_OPENCLAW = 1;
+/**
+ * WeCom 双模式常量定义
+ */
+/** 固定 Webhook 路径 */
+export declare const WEBHOOK_PATHS: {
+    /** Bot 模式历史兼容路径（不再维护） */
+    readonly BOT: "/wecom";
+    /** Bot 模式历史备用兼容路径（不再维护） */
+    readonly BOT_ALT: "/wecom/bot";
+    /** Agent 模式历史兼容路径（不再维护） */
+    readonly AGENT: "/wecom/agent";
+    /** Bot 模式推荐路径前缀 */
+    readonly BOT_PLUGIN: "/plugins/wecom/bot";
+    /** Agent 模式推荐路径前缀 */
+    readonly AGENT_PLUGIN: "/plugins/wecom/agent";
+};
+/** 企业微信 API 端点 */
+export declare const API_ENDPOINTS: {
+    readonly GET_TOKEN: "https://qyapi.weixin.qq.com/cgi-bin/gettoken";
+    readonly SEND_MESSAGE: "https://qyapi.weixin.qq.com/cgi-bin/message/send";
+    readonly SEND_APPCHAT: "https://qyapi.weixin.qq.com/cgi-bin/appchat/send";
+    readonly UPLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/upload";
+    readonly DOWNLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/get";
+};
+/** 各类限制常量 */
+export declare const LIMITS: {
+    /** 文本消息最大字节数 */
+    readonly TEXT_MAX_BYTES: 2048;
+    /** Token 刷新缓冲时间 (提前刷新) */
+    readonly TOKEN_REFRESH_BUFFER_MS: 60000;
+    /** HTTP 请求超时 */
+    readonly REQUEST_TIMEOUT_MS: 15000;
+    /** 最大请求体大小 */
+    readonly MAX_REQUEST_BODY_SIZE: number;
+};
+/** AES 加密常量 */
+export declare const CRYPTO: {
+    /** PKCS#7 块大小 */
+    readonly PKCS7_BLOCK_SIZE: 32;
+    /** AES Key 长度 */
+    readonly AES_KEY_LENGTH: 32;
+};
 /** 合法的模板卡片 card_type 列表 */
 export declare const VALID_CARD_TYPES: string[];
+/** 模板卡片缓存条目 TTL（毫秒）：24小时 */
+export declare const TEMPLATE_CARD_CACHE_TTL_MS: number;
+/** 模板卡片缓存最大条目数 */
+export declare const TEMPLATE_CARD_CACHE_MAX_SIZE = 300;

package/dist/src/const.js

@@ -0,0 +1,157 @@
+/**
+ * 企业微信渠道常量定义
+ */
+/**
+ * 企业微信渠道 ID
+ */
+export const CHANNEL_ID = "wecom";
+/**
+ * 企业微信 WebSocket 命令枚举
+ */
+export var WeComCommand;
+(function (WeComCommand) {
+    /** 认证订阅 */
+    WeComCommand["SUBSCRIBE"] = "aibot_subscribe";
+    /** 心跳 */
+    WeComCommand["PING"] = "ping";
+    /** 企业微信推送消息 */
+    WeComCommand["AIBOT_CALLBACK"] = "aibot_callback";
+    /** clawdbot 响应消息 */
+    WeComCommand["AIBOT_RESPONSE"] = "aibot_response";
+})(WeComCommand || (WeComCommand = {}));
+// ============================================================================
+// 超时和重试配置
+// ============================================================================
+/** 图片下载超时时间（毫秒） */
+export const IMAGE_DOWNLOAD_TIMEOUT_MS = 30_000;
+/** 文件下载超时时间（毫秒） */
+export const FILE_DOWNLOAD_TIMEOUT_MS = 60_000;
+/** 消息发送超时时间（毫秒） */
+export const REPLY_SEND_TIMEOUT_MS = 15_000;
+/** 消息处理总超时时间（毫秒） */
+export const MESSAGE_PROCESS_TIMEOUT_MS = 6 * 60 * 1000;
+/** WebSocket 心跳间隔（毫秒） */
+export const WS_HEARTBEAT_INTERVAL_MS = 30_000;
+/** WebSocket 连接断开时的最大重连次数 */
+export const WS_MAX_RECONNECT_ATTEMPTS = 10;
+/** WebSocket 认证失败时的最大重试次数 */
+export const WS_MAX_AUTH_FAILURE_ATTEMPTS = 5;
+// ============================================================================
+// 消息状态管理配置
+// ============================================================================
+/** messageStates Map 条目的最大 TTL（毫秒），防止内存泄漏 */
+export const MESSAGE_STATE_TTL_MS = 10 * 60 * 1000;
+/** messageStates Map 清理间隔（毫秒） */
+export const MESSAGE_STATE_CLEANUP_INTERVAL_MS = 60_000;
+/** messageStates Map 最大条目数 */
+export const MESSAGE_STATE_MAX_SIZE = 500;
+// ============================================================================
+// 消息模板
+// ============================================================================
+/** "思考中"流式消息占位内容 */
+export const THINKING_MESSAGE = "<think></think>";
+/** 仅包含图片时的消息占位符 */
+export const MEDIA_IMAGE_PLACEHOLDER = "<media:image>";
+/** 仅包含文件时的消息占位符 */
+export const MEDIA_DOCUMENT_PLACEHOLDER = "<media:document>";
+// ============================================================================
+// 默认值
+// ============================================================================
+// ============================================================================
+// MCP 配置
+// ============================================================================
+/** 获取 MCP 配置的 WebSocket 命令 */
+export const MCP_GET_CONFIG_CMD = "aibot_get_mcp_config";
+/** MCP 配置拉取超时时间（毫秒） */
+export const MCP_CONFIG_FETCH_TIMEOUT_MS = 15_000;
+// ============================================================================
+// 默认值
+// ============================================================================
+/** 默认媒体大小上限（MB） */
+export const DEFAULT_MEDIA_MAX_MB = 5;
+/** 文本分块大小上限 */
+export const TEXT_CHUNK_LIMIT = 4000;
+// ============================================================================
+// 媒体上传相关常量
+// ============================================================================
+/** 图片大小上限（字节）：10MB */
+export const IMAGE_MAX_BYTES = 10 * 1024 * 1024;
+/** 视频大小上限（字节）：10MB */
+export const VIDEO_MAX_BYTES = 10 * 1024 * 1024;
+/** 语音大小上限（字节）：2MB */
+export const VOICE_MAX_BYTES = 2 * 1024 * 1024;
+/** 文件大小上限（字节）：20MB */
+export const FILE_MAX_BYTES = 20 * 1024 * 1024;
+/** 文件绝对上限（字节）：超过此值无法发送，等于 FILE_MAX_BYTES */
+export const ABSOLUTE_MAX_BYTES = FILE_MAX_BYTES;
+/** 上传分片大小（字节，Base64 编码前）：512KB */
+export const UPLOAD_CHUNK_SIZE = 512 * 1024;
+// ============================================================================
+// 事件/命令名称常量
+// ============================================================================
+/** 版本检查事件名称（SDK 事件监听用） */
+export const EVENT_ENTER_CHECK_UPDATE = "event.enter_check_update";
+/** 版本检查事件回复命令名称 */
+export const CMD_ENTER_EVENT_REPLY = "ww_ai_robot_enter_event";
+// ============================================================================
+// SDK 连接配置
+// ============================================================================
+/** WSClient scene 参数：企微 OpenClaw 场景 */
+export const SCENE_WECOM_OPENCLAW = 1;
+/**
+ * WeCom 双模式常量定义
+ */
+/** 固定 Webhook 路径 */
+export const WEBHOOK_PATHS = {
+    /** Bot 模式历史兼容路径（不再维护） */
+    BOT: "/wecom",
+    /** Bot 模式历史备用兼容路径（不再维护） */
+    BOT_ALT: "/wecom/bot",
+    /** Agent 模式历史兼容路径（不再维护） */
+    AGENT: "/wecom/agent",
+    /** Bot 模式推荐路径前缀 */
+    BOT_PLUGIN: "/plugins/wecom/bot",
+    /** Agent 模式推荐路径前缀 */
+    AGENT_PLUGIN: "/plugins/wecom/agent",
+};
+/** 企业微信 API 端点 */
+export const API_ENDPOINTS = {
+    GET_TOKEN: "https://qyapi.weixin.qq.com/cgi-bin/gettoken",
+    SEND_MESSAGE: "https://qyapi.weixin.qq.com/cgi-bin/message/send",
+    SEND_APPCHAT: "https://qyapi.weixin.qq.com/cgi-bin/appchat/send",
+    UPLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/upload",
+    DOWNLOAD_MEDIA: "https://qyapi.weixin.qq.com/cgi-bin/media/get",
+};
+/** 各类限制常量 */
+export const LIMITS = {
+    /** 文本消息最大字节数 */
+    TEXT_MAX_BYTES: 2048,
+    /** Token 刷新缓冲时间 (提前刷新) */
+    TOKEN_REFRESH_BUFFER_MS: 60_000,
+    /** HTTP 请求超时 */
+    REQUEST_TIMEOUT_MS: 15_000,
+    /** 最大请求体大小 */
+    MAX_REQUEST_BODY_SIZE: 1024 * 1024,
+};
+/** AES 加密常量 */
+export const CRYPTO = {
+    /** PKCS#7 块大小 */
+    PKCS7_BLOCK_SIZE: 32,
+    /** AES Key 长度 */
+    AES_KEY_LENGTH: 32,
+};
+// ============================================================================
+// 模板卡片配置
+// ============================================================================
+/** 合法的模板卡片 card_type 列表 */
+export const VALID_CARD_TYPES = [
+    "text_notice",
+    "news_notice",
+    "button_interaction",
+    "vote_interaction",
+    "multiple_interaction",
+];
+/** 模板卡片缓存条目 TTL（毫秒）：24小时 */
+export const TEMPLATE_CARD_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+/** 模板卡片缓存最大条目数 */
+export const TEMPLATE_CARD_CACHE_MAX_SIZE = 300;

package/dist/src/dm-policy.js

@@ -0,0 +1,84 @@
+/**
+ * 企业微信 DM（私聊）访问控制模块
+ *
+ * 负责私聊策略检查、配对流程
+ */
+import { getWeComRuntime } from "./runtime.js";
+import { CHANNEL_ID } from "./const.js";
+import { sendWeComReply } from "./message-sender.js";
+import { isSenderAllowed } from "./group-policy.js";
+// ============================================================================
+// 公开 API
+// ============================================================================
+/**
+ * 检查 DM Policy 访问控制
+ * @returns 检查结果，包含是否允许继续处理
+ */
+export async function checkDmPolicy(params) {
+    const { senderId, isGroup, account, wsClient, frame, runtime } = params;
+    const core = getWeComRuntime();
+    // 群聊消息不检查 DM Policy
+    if (isGroup) {
+        return { allowed: true };
+    }
+    const dmPolicy = account.config.dmPolicy ?? "open";
+    const configAllowFrom = (account.config.allowFrom ?? []).map((v) => String(v));
+    // 如果 dmPolicy 是 disabled，直接拒绝
+    if (dmPolicy === "disabled") {
+        runtime.log?.(`[WeCom] Blocked DM from ${senderId} (dmPolicy=disabled)`);
+        return { allowed: false };
+    }
+    // 如果是 open 模式，允许所有人
+    if (dmPolicy === "open") {
+        return { allowed: true };
+    }
+    // OpenClaw <= 2026.2.19 signature: readAllowFromStore(channel, env?, accountId?)
+    // @ts-expect-error — 兼容旧版 SDK 的三参数签名，新版已改为单参数对象
+    const oldStoreAllowFrom = await core.channel.pairing.readAllowFromStore('wecom', undefined, account.accountId).catch(() => []);
+    // Compatibility fallback for newer OpenClaw implementations.
+    const newStoreAllowFrom = await core.channel.pairing
+        .readAllowFromStore({ channel: CHANNEL_ID, accountId: account.accountId })
+        .catch(() => []);
+    // 检查发送者是否在允许列表中
+    const storeAllowFrom = [...oldStoreAllowFrom, ...newStoreAllowFrom];
+    const effectiveAllowFrom = [...configAllowFrom, ...storeAllowFrom];
+    const senderAllowedResult = isSenderAllowed(senderId, effectiveAllowFrom);
+    if (senderAllowedResult) {
+        return { allowed: true };
+    }
+    // 处理未授权用户
+    if (dmPolicy === "pairing") {
+        const { code, created } = await core.channel.pairing.upsertPairingRequest({
+            channel: CHANNEL_ID,
+            id: senderId,
+            accountId: account.accountId,
+            meta: { name: senderId },
+        });
+        if (created) {
+            runtime.log?.(`[WeCom] Pairing request created for sender=${senderId}`);
+            try {
+                await sendWeComReply({
+                    wsClient,
+                    frame,
+                    text: core.channel.pairing.buildPairingReply({
+                        channel: CHANNEL_ID,
+                        idLine: `您的企业微信用户ID: ${senderId}`,
+                        code,
+                    }),
+                    runtime,
+                    finish: true,
+                });
+            }
+            catch (err) {
+                runtime.error?.(`[WeCom] Failed to send pairing reply to ${senderId}: ${String(err)}`);
+            }
+        }
+        else {
+            runtime.log?.(`[WeCom] Pairing request already exists for sender=${senderId}`);
+        }
+        return { allowed: false, pairingSent: created };
+    }
+    // allowlist 模式：直接拒绝未授权用户
+    runtime.log?.(`[WeCom] Blocked unauthorized sender ${senderId} (dmPolicy=${dmPolicy})`);
+    return { allowed: false };
+}

package/dist/src/dynamic-agent.d.ts

@@ -0,0 +1,37 @@
+/**
+ * **动态 Agent 路由模块**
+ *
+ * 为每个用户/群组自动生成独立的 Agent ID，实现会话隔离。
+ * 参考: openclaw-plugin-wecom/dynamic-agent.js
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk";
+export interface DynamicAgentConfig {
+    enabled: boolean;
+    dmCreateAgent: boolean;
+    groupEnabled: boolean;
+    adminUsers: string[];
+}
+/**
+ * **getDynamicAgentConfig (读取动态 Agent 配置)**
+ *
+ * 从全局配置中读取动态 Agent 配置，提供默认值。
+ */
+export declare function getDynamicAgentConfig(config: OpenClawConfig): DynamicAgentConfig;
+/**
+ * **generateAgentId (生成动态 Agent ID)**
+ *
+ * 根据账号 + 聊天类型 + 对端 ID 生成确定性的 Agent ID，避免多账号串会话。
+ * 格式: wecom-{accountId}-{type}-{sanitizedPeerId}
+ */
+export declare function generateAgentId(chatType: "dm" | "group", peerId: string, accountId?: string): string;
+/**
+ * **shouldUseDynamicAgent (检查是否使用动态 Agent)**
+ *
+ * 根据配置和发送者信息判断是否应使用动态 Agent。
+ * 管理员（adminUsers）始终绕过动态路由，使用主 Agent。
+ */
+export declare function shouldUseDynamicAgent(params: {
+    chatType: "dm" | "group";
+    senderId: string;
+    config: OpenClawConfig;
+}): boolean;

package/dist/src/dynamic-agent.js

@@ -0,0 +1,60 @@
+/**
+ * **动态 Agent 路由模块**
+ *
+ * 为每个用户/群组自动生成独立的 Agent ID，实现会话隔离。
+ * 参考: openclaw-plugin-wecom/dynamic-agent.js
+ */
+/**
+ * **getDynamicAgentConfig (读取动态 Agent 配置)**
+ *
+ * 从全局配置中读取动态 Agent 配置，提供默认值。
+ */
+export function getDynamicAgentConfig(config) {
+    const dynamicAgents = config?.channels?.wecom?.dynamicAgents;
+    return {
+        enabled: dynamicAgents?.enabled ?? false,
+        dmCreateAgent: dynamicAgents?.dmCreateAgent ?? true,
+        groupEnabled: dynamicAgents?.groupEnabled ?? true,
+        adminUsers: dynamicAgents?.adminUsers ?? [],
+    };
+}
+function sanitizeDynamicIdPart(value) {
+    return String(value)
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, "_");
+}
+/**
+ * **generateAgentId (生成动态 Agent ID)**
+ *
+ * 根据账号 + 聊天类型 + 对端 ID 生成确定性的 Agent ID，避免多账号串会话。
+ * 格式: wecom-{accountId}-{type}-{sanitizedPeerId}
+ */
+export function generateAgentId(chatType, peerId, accountId) {
+    const sanitizedPeer = sanitizeDynamicIdPart(peerId) || "unknown";
+    const sanitizedAccountId = sanitizeDynamicIdPart(accountId ?? "default") || "default";
+    return `wecom-${sanitizedAccountId}-${chatType}-${sanitizedPeer}`;
+}
+/**
+ * **shouldUseDynamicAgent (检查是否使用动态 Agent)**
+ *
+ * 根据配置和发送者信息判断是否应使用动态 Agent。
+ * 管理员（adminUsers）始终绕过动态路由，使用主 Agent。
+ */
+export function shouldUseDynamicAgent(params) {
+    const { chatType, senderId, config } = params;
+    const dynamicConfig = getDynamicAgentConfig(config);
+    if (!dynamicConfig.enabled) {
+        return false;
+    }
+    // 管理员绕过动态路由
+    const sender = String(senderId).trim().toLowerCase();
+    const isAdmin = dynamicConfig.adminUsers.some((admin) => admin.trim().toLowerCase() === sender);
+    if (isAdmin) {
+        return false;
+    }
+    if (chatType === "group") {
+        return dynamicConfig.groupEnabled;
+    }
+    return dynamicConfig.dmCreateAgent;
+}

package/dist/src/dynamic-routing.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 动态路由统一处理模块
+ * 提供统一的路由注入接口。
+ */
+import type { OpenClawConfig } from "openclaw/plugin-sdk/core";
+import type { PluginRuntime } from "openclaw/plugin-sdk";
+/**
+ * 路由对象（从 core.channel.routing.resolveAgentRoute 返回）
+ */
+export interface AgentRoute {
+    agentId: string;
+    sessionKey: string;
+    matchedBy: string;
+    accountId: string;
+    mainSessionKey?: string;
+}
+/**
+ * 动态路由处理参数
+ */
+export interface DynamicRoutingParams {
+    /** 原始路由对象 */
+    route: AgentRoute;
+    /** 全局配置 */
+    config: OpenClawConfig;
+    /** 插件运行时 */
+    core: PluginRuntime;
+    /** 账号 ID */
+    accountId: string;
+    /** 会话类型 */
+    chatType: "group" | "dm";
+    /** 对话 ID（群聊为 chatId，私聊为 userId） */
+    chatId: string;
+    /** 发送者用户 ID */
+    senderId: string;
+    /** 日志输出函数（可选） */
+    log?: (msg: string) => void;
+    /** 错误日志输出函数（可选） */
+    error?: (msg: string) => void;
+}
+/**
+ * 动态路由处理结果
+ */
+export interface DynamicRoutingResult {
+    /** 是否使用动态 Agent */
+    useDynamicAgent: boolean;
+    /** 是否被默认路由拦截 */
+    rejected: boolean;
+    /** 拒绝原因（如果 rejected=true） */
+    rejectReason?: string;
+    /** 最终的 agentId（可能被动态注入修改） */
+    finalAgentId: string;
+    /** 最终的 sessionKey（可能被动态注入修改） */
+    finalSessionKey: string;
+    /** 是否修改了路由（注入了动态 Agent） */
+    routeModified: boolean;
+}
+/**
+ * 统一处理动态路由注入逻辑
+ *
+ * 功能：
+ * 1. 判断是否需要使用动态 Agent
+ * 2. 根据 matchedBy 判断配置类型
+ * 3. 检查是否被默认路由拦截（fail-closed 策略）
+ * 4. 返回最终的路由信息（不修改传入的 route 对象）
+ * 5. 输出详细的调试日志
+ *
+ * **重要规则**：
+ * - matchedBy = "binding.peer" 或 "binding.peer.parent" → 跳过动态路由
+ * - matchedBy = "binding.account" 或其他 → 继续使用动态路由
+ * - matchedBy = "default" → 检查 fail-closed 策略
+ *
+ * @param params 动态路由处理参数
+ * @returns 处理结果
+ */
+export declare function processDynamicRouting(params: DynamicRoutingParams): DynamicRoutingResult;

package/dist/src/dynamic-routing.js

@@ -0,0 +1,124 @@
+/**
+ * 动态路由统一处理模块
+ * 提供统一的路由注入接口。
+ */
+import { shouldUseDynamicAgent, generateAgentId } from "./dynamic-agent.js";
+import { shouldRejectWecomDefaultRoute } from "./routing.js";
+/**
+ * 根据 matchedBy 和配置内容判断是否应该跳过动态路由
+ * **重要**：即使 matchedBy=binding.peer，也需要检查配置的 peer.kind 是否与实际聊天类型匹配
+ * @param params 判断参数
+ * @returns 是否跳过动态路由
+ */
+function shouldSkipDynamicRouting(params) {
+    const { matchedBy, config, route, chatType, log } = params;
+    // 只有精确匹配到 peer 时才可能跳过动态路由
+    if (matchedBy !== "binding.peer" && matchedBy !== "binding.peer.parent") {
+        return false;
+    }
+    const binding = config.bindings?.find(b => b.agentId === route.agentId);
+    if (!binding) {
+        log?.(`[dynamic-routing] ⚠️  警告：matchedBy=binding.peer，但在配置中找不到 agentId=${route.agentId} 的 binding`);
+        return false;
+    }
+    // 检查配置的 peer.kind 是否与实际聊天类型匹配
+    const configuredKind = binding.match?.peer?.kind;
+    if (!configuredKind) {
+        // 配置中没有指定 kind，使用动态路由
+        log?.(`[dynamic-routing] ℹ️  binding 未指定`);
+        return false;
+    }
+    const actualKind = chatType === "group" ? "group" : "direct";
+    if (configuredKind !== actualKind) {
+        // 类型不匹配，继续使用动态路由
+        log?.(`[dynamic-routing] ⚠️  binding 配置的聊天类型 (${configuredKind}) 与实际类型 (${actualKind}) 不匹配，继续使用动态路由`);
+        return false;
+    }
+    // 类型匹配，跳过动态路由
+    return true;
+}
+/**
+ * 统一处理动态路由注入逻辑
+ *
+ * 功能：
+ * 1. 判断是否需要使用动态 Agent
+ * 2. 根据 matchedBy 判断配置类型
+ * 3. 检查是否被默认路由拦截（fail-closed 策略）
+ * 4. 返回最终的路由信息（不修改传入的 route 对象）
+ * 5. 输出详细的调试日志
+ *
+ * **重要规则**：
+ * - matchedBy = "binding.peer" 或 "binding.peer.parent" → 跳过动态路由
+ * - matchedBy = "binding.account" 或其他 → 继续使用动态路由
+ * - matchedBy = "default" → 检查 fail-closed 策略
+ *
+ * @param params 动态路由处理参数
+ * @returns 处理结果
+ */
+export function processDynamicRouting(params) {
+    const { route, config, accountId, chatType, chatId, senderId, log } = params;
+    log?.(`[dynamic-routing] 🔍 调试 - matchedBy=${route.matchedBy}, agentId=${route.agentId}`);
+    if (route.matchedBy !== "default") {
+        // 根据 matchedBy 和配置内容判断是否跳过动态路由
+        if (shouldSkipDynamicRouting({ matchedBy: route.matchedBy, config, route, chatType, log })) {
+            // 精确配置（binding.peer）且类型匹配，跳过动态路由
+            log?.(`[dynamic-routing] ℹ️  检测到精确配置的 bindings (matchedBy=${route.matchedBy})，且聊天类型匹配，跳过动态路由`);
+            return {
+                useDynamicAgent: false,
+                rejected: false,
+                finalAgentId: route.agentId,
+                finalSessionKey: route.sessionKey,
+                routeModified: false,
+            };
+        }
+        else {
+            // 其他类型的配置（binding.account、binding.channel 等），继续使用动态路由
+            log?.(`[dynamic-routing] ℹ️  检测到非精确配置的 bindings (matchedBy=${route.matchedBy})，继续使用动态路由`);
+        }
+    }
+    // 判断是否使用动态 Agent
+    const useDynamicAgent = shouldUseDynamicAgent({
+        chatType,
+        senderId,
+        config,
+    });
+    // 检查是否被默认路由拦截
+    const rejected = shouldRejectWecomDefaultRoute({
+        cfg: config,
+        matchedBy: route.matchedBy,
+        useDynamicAgent,
+    });
+    if (rejected) {
+        const rejectReason = `当前账号（${accountId}）未绑定 OpenClaw Agent，已拒绝回退到默认主智能体。请在 bindings 中添加：{"agentId":"你的Agent","match":{"channel":"wecom","accountId":"${accountId}"}}`;
+        return {
+            useDynamicAgent,
+            rejected: true,
+            rejectReason,
+            finalAgentId: route.agentId,
+            finalSessionKey: route.sessionKey,
+            routeModified: false,
+        };
+    }
+    // 使用动态 Agent
+    if (useDynamicAgent) {
+        log?.(`[dynamic-routing] 原始路由信息: agentId=${route.agentId}, matchedBy=${route.matchedBy}, sessionKey=${route.sessionKey}`);
+        const targetAgentId = generateAgentId(chatType, chatId, accountId);
+        const targetSessionKey = `agent:${targetAgentId}:wecom:${accountId}:${chatType}:${chatId}`;
+        log?.(`[dynamic-routing] 🔄 路由注入: agentId=${targetAgentId}, sessionKey=${targetSessionKey}`);
+        return {
+            useDynamicAgent: true,
+            rejected: false,
+            finalAgentId: targetAgentId,
+            finalSessionKey: targetSessionKey,
+            routeModified: true,
+        };
+    }
+    // 不使用动态 Agent，返回原始路由
+    return {
+        useDynamicAgent: false,
+        rejected: false,
+        finalAgentId: route.agentId,
+        finalSessionKey: route.sessionKey,
+        routeModified: false,
+    };
+}