# 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 开通相应业务类别；插件侧已经具备调用链，但实际可用范围仍以企业微信侧授权为准。
