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

> [!WARNING]
> **可用性热修复版本**：`v2.3.4` 重点修复 OpenClaw 3.1+ 下 WeCom webhook 路由兼容与可达性问题，保障历史配置可继续使用。

## 2026-03-03（v2.3.4 热修复）
- 【SDK适配】♻️ 插件入口从 `registerHttpHandler` 迁移为 `registerHttpRoute`（`/plugins/wecom` + `match=prefix` + `auth=plugin`），兼容 OpenClaw 新版插件 HTTP 注册模型。  
- 【兼容修复】🔁 补回旧路径入口注册：新增 `/wecom` 前缀路由注册，确保历史 Bot/Agent webhook 继续可达。  
- 【模式兼容】🧭 保持 legacy 单账号配置可运行，并明确 matrix 模式必须使用带 `accountId` 的回调路径。  

## 影响说明
- WeCom Bot/Agent 业务链路保持兼容；核心变化为插件 HTTP 注册 API 的升级适配与旧路径可达性恢复。  

## 兼容矩阵（单账号/多账号）
| 场景 | 配置形态 | 回调地址 | 兼容状态 | 说明 |
|---|---|---|---|---|
| 历史单账号（legacy） | `channels.wecom.bot/agent` | Bot: `/wecom`（默认）或 `/wecom/bot`；Agent: `/wecom/agent` | ✅ 兼容保留 | 适用于存量部署，不作为新引导方案。 |
| 多账号（matrix）错误用法 | `channels.wecom.accounts.*` | `/wecom/bot`、`/wecom/agent`（无 accountId） | ❌ 不可用 | 会返回 `wecom_matrix_path_required`。 |
| 多账号（matrix）兼容路径 | `channels.wecom.accounts.*` | `/wecom/bot/{accountId}`、`/wecom/agent/{accountId}` | ✅ 兼容保留 | 历史路径可用，但不再维护。 |
| 多账号（matrix）推荐路径 | `channels.wecom.accounts.*` | `/plugins/wecom/bot/{accountId}`、`/plugins/wecom/agent/{accountId}` | ✅ 推荐 | 当前主维护路径。 |