@mocrane/wecom 2026.2.5 → 2026.2.27

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@mocrane/wecom",
-  "version": "2026.2.5",
+  "version": "2026.2.27",
   "type": "module",
   "description": "OpenClaw WeCom (WeChat Work) intelligent bot channel plugin",
   "main": "index.ts",
   "files": [
     "index.ts",
     "src/",
+    "assets/",
     "openclaw.plugin.json",
     "clawdbot.plugin.json",
     "README.md",

package/src/agent/handler.ts

@@ -17,6 +17,7 @@ import { getWecomRuntime } from "../runtime.js";
 import type { WecomAgentInboundMessage } from "../types/index.js";
 import { buildWecomUnauthorizedCommandPrompt, resolveWecomCommandAuthorization } from "../shared/command-auth.js";
 import { resolveWecomMediaMaxBytes } from "../config/index.js";
+import { generateAgentId, shouldUseDynamicAgent, ensureDynamicAgentListed } from "../dynamic-agent.js";
 
 /** 错误提示信息 */
 const ERROR_HELP = "";
@@ -442,6 +443,26 @@ async function processAgentMessage(params: {
         peer: { kind: isGroup ? "group" : "dm", id: peerId },
     });
 
+    // ===== 动态 Agent 路由注入 =====
+    const useDynamicAgent = shouldUseDynamicAgent({
+        chatType: isGroup ? "group" : "dm",
+        senderId: fromUser,
+        config,
+    });
+
+    if (useDynamicAgent) {
+        const targetAgentId = generateAgentId(
+            isGroup ? "group" : "dm",
+            peerId
+        );
+        route.agentId = targetAgentId;
+        route.sessionKey = `agent:${targetAgentId}:${isGroup ? "group" : "dm"}:${peerId}`;
+        // 异步添加到 agents.list（不阻塞）
+        ensureDynamicAgentListed(targetAgentId, core).catch(() => {});
+        log?.(`[wecom-agent] dynamic agent routing: ${targetAgentId}, sessionKey=${route.sessionKey}`);
+    }
+    // ===== 动态 Agent 路由注入结束 =====
+
     // 构建上下文
     const fromLabel = isGroup ? `group:${peerId}` : `user:${fromUser}`;
     const storePath = core.channel.session.resolveStorePath(config.session?.store, {

package/src/config/schema.ts

@@ -92,6 +92,22 @@ const agentSchema = z.object({
     dm: dmSchema,
 }).optional();
 
+/**
+ * **dynamicAgentsSchema (动态 Agent 配置)**
+ *
+ * 控制是否按用户/群组自动创建独立 Agent 实例。
+ * @property enabled - 是否启用动态 Agent
+ * @property dmCreateAgent - 私聊是否为每个用户创建独立 Agent
+ * @property groupEnabled - 群聊是否启用动态 Agent
+ * @property adminUsers - 管理员列表（绕过动态路由）
+ */
+const dynamicAgentsSchema = z.object({
+    enabled: z.boolean().optional(),
+    dmCreateAgent: z.boolean().optional(),
+    groupEnabled: z.boolean().optional(),
+    adminUsers: z.array(z.string()).optional(),
+}).optional();
+
 /** 顶层 WeCom 配置 Schema */
 export const WecomConfigSchema = z.object({
     enabled: z.boolean().optional(),
@@ -99,6 +115,7 @@ export const WecomConfigSchema = z.object({
     agent: agentSchema,
     media: mediaSchema,
     network: networkSchema,
+    dynamicAgents: dynamicAgentsSchema,
 });
 
 export type WecomConfigInput = z.infer<typeof WecomConfigSchema>;

package/src/dynamic-agent.ts

@@ -0,0 +1,178 @@
+/**
+ * **动态 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 function getDynamicAgentConfig(config: OpenClawConfig): DynamicAgentConfig {
+    const dynamicAgents = (config as { channels?: { wecom?: { dynamicAgents?: Partial<DynamicAgentConfig> } } })?.channels?.wecom?.dynamicAgents;
+    return {
+        enabled: dynamicAgents?.enabled ?? false,
+        dmCreateAgent: dynamicAgents?.dmCreateAgent ?? true,
+        groupEnabled: dynamicAgents?.groupEnabled ?? true,
+        adminUsers: dynamicAgents?.adminUsers ?? [],
+    };
+}
+
+/**
+ * **generateAgentId (生成动态 Agent ID)**
+ *
+ * 根据聊天类型和对端 ID 生成确定性的 Agent ID。
+ * 格式: wecom-{type}-{sanitizedPeerId}
+ * - type: dm | group
+ * - sanitizedPeerId: 小写，非字母数字下划线横线替换为下划线
+ *
+ * @example
+ * generateAgentId("dm", "ZhangSan") // "wecom-dm-zhangsan"
+ * generateAgentId("group", "wr123456") // "wecom-group-wr123456"
+ */
+export function generateAgentId(chatType: "dm" | "group", peerId: string): string {
+    const sanitized = String(peerId)
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]/g, "_");
+    return `wecom-${chatType}-${sanitized}`;
+}
+
+/**
+ * **shouldUseDynamicAgent (检查是否使用动态 Agent)**
+ *
+ * 根据配置和发送者信息判断是否应使用动态 Agent。
+ * 管理员（adminUsers）始终绕过动态路由，使用主 Agent。
+ */
+export function shouldUseDynamicAgent(params: {
+    chatType: "dm" | "group";
+    senderId: string;
+    config: OpenClawConfig;
+}): boolean {
+    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;
+}
+
+/**
+ * 内存中已确保的 Agent ID（避免重复写入）
+ */
+const ensuredDynamicAgentIds = new Set<string>();
+
+/**
+ * 写入队列（避免并发冲突）
+ */
+let ensureDynamicAgentWriteQueue: Promise<void> = Promise.resolve();
+
+/**
+ * 将 Agent ID 插入 agents.list（如果不存在）
+ */
+function upsertAgentIdOnlyEntry(cfg: Record<string, unknown>, agentId: string): boolean {
+    if (!cfg.agents || typeof cfg.agents !== "object") {
+        cfg.agents = {};
+    }
+
+    const agentsObj = cfg.agents as Record<string, unknown>;
+    const currentList: Array<{ id: string }> = Array.isArray(agentsObj.list) ? agentsObj.list as Array<{ id: string }> : [];
+    const existingIds = new Set(
+        currentList
+            .map((entry) => entry?.id?.trim().toLowerCase())
+            .filter((id): id is string => Boolean(id))
+    );
+
+    let changed = false;
+    const nextList = [...currentList];
+
+    // 首次创建时保留 main 作为默认
+    if (nextList.length === 0) {
+        nextList.push({ id: "main" });
+        existingIds.add("main");
+        changed = true;
+    }
+
+    if (!existingIds.has(agentId.toLowerCase())) {
+        nextList.push({ id: agentId });
+        changed = true;
+    }
+
+    if (changed) {
+        agentsObj.list = nextList;
+    }
+
+    return changed;
+}
+
+/**
+ * **ensureDynamicAgentListed (确保动态 Agent 已添加到 agents.list)**
+ *
+ * 将动态生成的 Agent ID 添加到 OpenClaw 配置中的 agents.list。
+ * 特性：
+ * - 幂等：使用内存 Set 避免重复写入
+ * - 串行：使用 Promise 队列避免并发冲突
+ * - 异步：不阻塞消息处理流程
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export async function ensureDynamicAgentListed(agentId: string, runtime: any): Promise<void> {
+    const normalizedId = String(agentId).trim().toLowerCase();
+    if (!normalizedId) return;
+    if (ensuredDynamicAgentIds.has(normalizedId)) return;
+
+    const configRuntime = runtime?.config;
+    if (!configRuntime?.loadConfig || !configRuntime?.writeConfigFile) return;
+
+    ensureDynamicAgentWriteQueue = ensureDynamicAgentWriteQueue
+        .then(async () => {
+            if (ensuredDynamicAgentIds.has(normalizedId)) return;
+
+            const latestConfig = configRuntime.loadConfig!();
+            if (!latestConfig || typeof latestConfig !== "object") return;
+
+            const changed = upsertAgentIdOnlyEntry(latestConfig as Record<string, unknown>, normalizedId);
+            if (changed) {
+                await configRuntime.writeConfigFile!(latestConfig as unknown);
+            }
+
+            ensuredDynamicAgentIds.add(normalizedId);
+        })
+        .catch((err) => {
+            console.warn(`[wecom] 动态 Agent 添加失败: ${normalizedId}`, err);
+        });
+
+    await ensureDynamicAgentWriteQueue;
+}
+
+/**
+ * **resetEnsuredCache (重置已确保缓存)**
+ *
+ * 主要用于测试场景，重置内存中的缓存状态。
+ */
+export function resetEnsuredCache(): void {
+    ensuredDynamicAgentIds.clear();
+}

package/src/monitor.ts

@@ -28,6 +28,7 @@ import axios from "axios";
 import type { WecomRuntimeEnv, WecomWebhookTarget, StreamState, PendingInbound, ActiveReplyState } from "./monitor/types.js";
 import { monitorState, LIMITS } from "./monitor/state.js";
 import { buildWecomUnauthorizedCommandPrompt, resolveWecomCommandAuthorization } from "./shared/command-auth.js";
+import { generateAgentId, shouldUseDynamicAgent, ensureDynamicAgentListed } from "./dynamic-agent.js";
 
 // Global State
 monitorState.streamStore.setFlushHandler((pending) => void flushPending(pending));
@@ -927,6 +928,26 @@ async function startAgentForStream(params: {
     peer: { kind: chatType === "group" ? "group" : "dm", id: chatId },
   });
 
+  // ===== 动态 Agent 路由注入 =====
+  const useDynamicAgent = shouldUseDynamicAgent({
+    chatType: chatType === "group" ? "group" : "dm",
+    senderId: userid,
+    config,
+  });
+
+  if (useDynamicAgent) {
+    const targetAgentId = generateAgentId(
+      chatType === "group" ? "group" : "dm",
+      chatId
+    );
+    route.agentId = targetAgentId;
+    route.sessionKey = `agent:${targetAgentId}:${chatType === "group" ? "group" : "dm"}:${chatId}`;
+    // 异步添加到 agents.list（不阻塞）
+    ensureDynamicAgentListed(targetAgentId, core).catch(() => {});
+    logVerbose(target, `dynamic agent routing: ${targetAgentId}, sessionKey=${route.sessionKey}`);
+  }
+  // ===== 动态 Agent 路由注入结束 =====
+
   logVerbose(target, `starting agent processing (streamId=${streamId}, agentId=${route.agentId}, peerKind=${chatType}, peerId=${chatId})`);
   logVerbose(target, `启动 Agent 处理: streamId=${streamId} 路由=${route.agentId} 类型=${chatType} ID=${chatId}`);
 

package/src/types/config.ts

@@ -70,6 +70,18 @@ export type WecomAgentConfig = {
     dm?: WecomDmConfig;
 };
 
+/** 动态 Agent 配置 */
+export type WecomDynamicAgentsConfig = {
+    /** 是否启用动态 Agent */
+    enabled?: boolean;
+    /** 私聊：是否为每个用户创建独立 Agent */
+    dmCreateAgent?: boolean;
+    /** 群聊：是否启用动态 Agent */
+    groupEnabled?: boolean;
+    /** 管理员列表（绕过动态路由，使用主 Agent） */
+    adminUsers?: string[];
+};
+
 /**
  * 顶层 WeCom 配置
  * 通过 bot / agent 字段隐式指定模式
@@ -85,4 +97,6 @@ export type WecomConfig = {
     media?: WecomMediaConfig;
     /** 网络配置 */
     network?: WecomNetworkConfig;
+    /** 动态 Agent 配置 */
+    dynamicAgents?: WecomDynamicAgentsConfig;
 };