@yanhaidao/wecom 2.3.150 → 2.3.180

package/changelog/v2.3.16.md

@@ -0,0 +1,11 @@
+# OpenClaw WeCom 插件 v2.3.16 变更简报
+
+> [!TIP]
+> **企业微信 Bot-WS 混合消息附件解析修复版本**：`v2.3.16` 重点解决了在 WebSocket 模式下，企业微信机器人接收到的混合消息（如同时包含图片和文字）由于解析遗漏导致附件丢失、AI 只能看到带签名的临时链接文本而无法查看真正图片内容的问题。
+
+## 2026-03-16（v2.3.16）
+- 【混合消息媒体解析修复】🛠 **[重要修复]** 补齐了 Bot WebSocket 传输通道（`bot-ws`）下对 `mixed` 结构消息的附件提取逻辑。现在，当用户在企微发出一条包含图片/文件与文字的混合消息时，底层框架会自动遍历并提取各个媒体节点的 URL 和 AES Key，确保核心处理管线能进行正常下载与安全解密。
+
+## 升级提示
+- 执行 `openclaw plugins update wecom` 即可升级到 `v2.3.16`。
+- 如果你之前在企微发出“带图的一段话”时，曾遇到 AI 回复说“这是一个腾讯 COS 的临时签名链接”，本次升级后，此问题将被修复，AI 将可以直接分析图片内容本身。

package/changelog/v2.3.18.md

@@ -0,0 +1,22 @@
+# OpenClaw WeCom 插件 v2.3.18 变更简报
+
+> [!TIP]
+> **企业微信面向中小企业的新能力开放版本**：`v2.3.18` 重点完善了 `wecom` 插件在 Bot WebSocket 场景下的能力层。现在，面向 5 人及以下小企业，OpenClaw 已支持以用户个人身份在企业微信内使用文档读写、日程读写、会议读写、待办读写、通讯录查询等能力。同时，本次也补齐了 Bot WS 媒体发送、建立了 Bot 与 Agent 双平面路由，并修复了企业微信里容易卡在“正在思考...”不结束的问题。
+
+## 2026-03-18（v2.3.18）
+- 【中小企业能力开放】🚀 **[重大更新]** 面向 5 人及以下小企业，OpenClaw 在企业微信内正式开放以用户个人身份使用的协作能力入口。现在，大模型可以在具备相应授权的前提下，调用企业微信文档读写、日程读写、会议读写、待办读写以及通讯录查询等能力，把原本分散在多个协作入口中的企业操作集中到同一条智能对话链路中。
+- 【新增 Bot WS MCP 工具层】新增 `wecom_mcp` 工具，将企业微信 Bot WS 能力以挂载式能力层接入 `wecom` 插件。现在 Bot 侧可以按业务类别动态获取 MCP 配置，并把企业微信开放的能力暴露给大模型调用。
+- 【建立 Bot / Agent 双平面路由】新增基于会话来源的能力分流。Bot WS 会话优先使用 `wecom_mcp`；Agent 回调会话继续保留原生 `wecom_doc`、`wecom_calendar` 工具链，避免不同能力面互相干扰。
+- 【多账号能力隔离加强】MCP 相关缓存和状态改为按 `accountId + category` 隔离。在多账号矩阵下，同一类能力不会再共用同一份 Bot 侧配置，减少串账号、串上下文、串连接状态的问题。
+- 【补齐 Bot WS 命令与媒体链】扩展 Bot WS 运行时接口，除了主动文本发送外，现在还支持命令桥接、连接状态探测和媒体发送。Bot WebSocket 会话下的图片、文件回复不再必须依赖 Agent API 补送。
+- 【新增媒体发送提示注入】在企业微信 Bot WS 会话里定向注入 `MEDIA:` 使用提示，帮助模型更稳定地触发图片和文件回复，同时避免把这类提示扩散到非 WeCom 或 Agent 会话。
+- 【修复回复流不收口问题】**[重要修复]** 处理 Bot WS 回复时，带媒体的中间块不再错误中断文本发送。现在文本会先正常下发，媒体在结束阶段继续处理；如果上游没有显式 final，系统也会自动补一个收口帧，避免企业微信里长期停留在“正在思考...”。
+- 【欢迎语路径提速】`enter_chat` 欢迎事件在配置静态欢迎语时改为直发，不再额外启动完整推理流程。首次进入会话时的响应更直接，链路也更短。
+- 【运行时日志增强】新增更细的派发与投递日志，包括 `dispatch-start`、`dispatch-done`、`dispatch-fail`、`deliver-start`、`deliver-done`。现在排查问题时可以更快区分是模型处理慢、回复已被企微确认、MCP 类别未开通，还是本地媒体路径被限制拦截。
+- 【能力边界提示更明确】当企业微信后台只开放部分能力时，插件会更明确地把限制反馈给用户和日志。例如只开通文档类能力时，待办、会议、日程类请求会直接提示当前账号尚未开放对应能力，而不是表现成模糊失败。
+
+## 升级提示
+- 执行 `openclaw plugins update wecom` 即可升级到 `v2.3.18`。
+- 本次版本是企业微信能力面的重要开放版本，尤其适合希望在企业微信内直接完成文档、日程、会议、待办与通讯录协作的小型团队。
+- 如果你之前在企业微信 Bot WS 会话里只看到反复“正在思考...”、最终不出结果，本次升级后应已修复。
+- 如果你希望在企业微信里直接使用会议、待办、日程等 Bot 侧能力，请同时确认企业微信后台已经为当前 Bot 开通相应业务类别；插件侧已经具备调用链，但实际可用范围仍以企业微信侧授权为准。

package/index.ts

@@ -3,11 +3,28 @@
  */
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { emptyPluginConfigSchema } from "openclaw/plugin-sdk";
-
+import { registerWecomCalendarTools } from "./src/capability/calendar/tool.js";
+import { registerWecomDocTools } from "./src/capability/doc/tool.js";
+import { createWeComMcpToolFactory } from "./src/capability/mcp/index.js";
+import { wecomPlugin } from "./src/channel.js";
 import { handleWecomWebhookRequest } from "./src/monitor.js";
 import { setWecomRuntime } from "./src/runtime.js";
-import { wecomPlugin } from "./src/channel.js";
-import { registerWecomDocTools } from "./src/capability/doc/tool.js";
+import { isWecomBotWsSource } from "./src/runtime/source-registry.js";
+
+const WECOM_BOT_WS_MEDIA_GUIDANCE = [
+  "【WeCom Bot WS 媒体发送】",
+  "当前会话支持企业微信 Bot WS 媒体发送。",
+  "当你需要发送图片、文件、视频或语音时，必须在回复中单独一行使用 MEDIA: 指令，后面跟本地文件路径。",
+  "格式：MEDIA: /文件的绝对路径",
+  "示例：",
+  "  MEDIA: ~/.openclaw/output.png",
+  "  MEDIA: ~/.openclaw/report.pdf",
+  "注意事项：",
+  "- MEDIA: 必须单独成行并以 MEDIA: 开头",
+  "- 建议优先使用本地可访问路径，而不是远程 URL",
+  "- 图片和视频超过 10MB、语音超过 2MB、文件超过 20MB 时可能会降级或发送失败",
+  "- 语音消息仅原生支持 AMR；其他音频格式会按文件发送",
+].join("\n");
 
 const plugin = {
   id: "wecom",
@@ -37,6 +54,25 @@ const plugin = {
 
     // Register WeCom Doc Tools
     registerWecomDocTools(api);
+    registerWecomCalendarTools(api);
+    api.registerTool(createWeComMcpToolFactory(), { name: "wecom_mcp" });
+
+    api.on("before_prompt_build", (_event, ctx) => {
+      if (ctx.channelId !== "wecom") {
+        return;
+      }
+      if (
+        !isWecomBotWsSource({
+          sessionKey: ctx.sessionKey,
+          sessionId: ctx.sessionId,
+        })
+      ) {
+        return;
+      }
+      return {
+        appendSystemContext: WECOM_BOT_WS_MEDIA_GUIDANCE,
+      };
+    });
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yanhaidao/wecom",
-  "version": "2.3.150",
+  "version": "2.3.180",
   "type": "module",
   "description": "OpenClaw 企业微信（WeCom）插件，默认 Bot WebSocket，支持加密媒体解密、Agent 主动发消息与多账号接入",
   "repository": {
@@ -42,8 +42,7 @@
   "dependencies": {
     "@wecom/aibot-node-sdk": "^1.0.0",
     "fast-xml-parser": "5.3.4",
-    "undici": "^7.20.0",
-    "zod": "^4.3.6"
+    "undici": "^7.20.0"
   },
   "peerDependencies": {
     "openclaw": ">=2026.2.24"

package/src/agent/handler.event-filter.test.ts

@@ -49,6 +49,17 @@ describe("shouldProcessAgentInboundMessage", () => {
         expect(missingSender.reason).toBe("missing_sender");
     });
 
+
+    it("allows group chat messages when sender id is missing", () => {
+        const groupWithoutSender = shouldProcessAgentInboundMessage({
+            msgType: "file",
+            fromUser: "   ",
+            chatId: "wrbchat_123",
+        });
+        expect(groupWithoutSender.shouldProcess).toBe(true);
+        expect(groupWithoutSender.reason).toBe("missing_sender_but_group_chat");
+    });
+
     it("allows normal user text message processing", () => {
         const normalMessage = shouldProcessAgentInboundMessage({
             msgType: "text",