# OpenClaw WeCom 插件 v2.3.14 变更简报

> [!TIP]
> **企业微信“协作文档”原生整合与长连接稳定性修复版本**：`v2.3.14` 将机器人的能力从“陪聊”正式拓展到了“办公协同”。现在，你可以直接在微信群里让机器人去填报销单、建项目表；同时我们也彻底修复了多人并发聊天时机器人“正在思考”卡死刷屏的问题。
>
> 📣 **特别感谢** [@proyy](https://github.com/proyy) 提供的企业微信文档管理解决方案，使本版本的 Docs 能力得以落地。

## 重磅功能：把聊天直接变成企业文档（用后即得）

我们受够了问 AI 一个问题，答案最后只能被新消息顶没。这次更新，我们让机器人获得了操作“企业微信协作文档”的实体权限。

### 场景 1：开新项目，不用再求人建表格拉权限了
- **以前**：你在群里说“准备一下下周的活动追踪表”，然后得切出去打开文档中心，新建表格，再一个个抄名字把大家拉进来。
- **现在**：直接在群里 `@机器人 帮我建一个名为『春季新品发布会追踪』的表格，并把群里的人都加上可写权限`。机器人建好后会直接在群里甩出一个链接，所有人点开就能直接编辑，全程零切换。

### 场景 2：坐在地铁上，照样神操作填报销/跟进数据
- **以前**：你刚下班，群里有人问“今天 C 组的面试谁通过了？”你只能回答“我等下回家用电脑打开「面试记录表」改一下状态”。全量改动很容易把别人的同行数据覆盖掉。
- **现在**：你可以直接发语音或者敲字 `@机器人 把「第二周面试记录表」里的 B2 到 B5 单元格全部更新为“二面通过”`。机器人会像操作手术刀一样，只精准替换指定的数据块（`spreadsheet.edit_data`），丝毫不影响文档里的其他公式。

### 场景 3：直接让 AI 读懂全公司的数据报表
- **以前**：你要先自己把表格下载成 Excel，再一段段复制数据发给大模型：“帮我算算这堆数据谁最高”。
- **现在**：你直接丢给他一个企微文档链接：`@机器人 分析一下这张表里的第一季度数据，告诉我谁的单产最差？`。由于具备了原生读取能力（`get_sheet_range_data`），它会自己去拉取数据查表，给你输出结论。

## 💡 Docs 权限配置指引（只需一次）

为了让上述场景跑通，光配 `agentSecret` 是不够的。这是因为哪怕是公司自建的机器人，默认也没资格动你们内部的文档资产。你需要：
1. **去企微后台发“通行证”**：进入 [企业微信后台 -> 协作 -> 文档 -> 可调用接口的应用](https://work.weixin.qq.com/wework_admin/frame#apps/qykit/proxy/wedoc)，把你的机器人应用放进白名单。
2. **在 OpenClaw 里激活能力**：打开 UI 界面 的 `Settings` -> `Agents` -> `Tools`，找到 `wecom`，把带有 `doc` 字眼的所有工具（创建文档、读取表格、改权限等）通通打勾。


## 核心修复：终结“正在思考...”刷屏噩梦
除了新功能，这次我们也彻底对长连接（WS）卡死问题做了一次大手术：
- 🛑 **告别并发刷屏**：群里人多手杂的时候，以前机器人如果处理不过来，不仅不回话，还会满屏一直弹“正在思考...”。现在只要有一条真回复发出来，它会自动把同群里那些卡死、过期的“正在思考”全部瞬间清理干净。
- 📡 **进群欢迎语报错 846605 终结**：修复了大家常反馈的“有人一进群，后台就疯狂报 invalid req_id”的陈年老 Bug。现在对进群、推卡片等非聊天事件，我们全面切换成了专属接口，彻底避免违规流式推送。
- 🛡 **120 秒物理断网**：即使模型源站点挂了，我们现在也会在 120 秒内强制熔断提示，绝不让你面对一个无限转圈的加载框。

---
## 验证结果
- `pnpm test -- src/transport/bot-ws`
- 所有 WS 回复通道单测已全部通过，尤其是关于 `setInterval` 占位符存活期的验证得到了补全与修复。

## 升级指引
```bash
openclaw plugins update wecom
```
- 无需新增配置，执行上述命令即可一键升级到 `v2.3.14`。
- 升级后，如果你拉几十个机器人进群并同时发言，曾经那种满屏飘“正在思考...”却无人回答的乱象将不复存在。
- 如果之前查看后台日志总是看到 `stream message update expired (>6 minutes)` 甚至因为连带引发的 WS 断网重启，本次升级将大幅度平息日志告警红字，稳定长连接状态。
