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

> [!TIP]
> **易用性与可观测性版本**：`v2.3.9` 重点优化默认 Bot WebSocket 接入体验、中文 onboarding、Bot/Agent 回调稳定性与排障日志。

## 2026-03-09（v2.3.9）
- 【默认接入】🚀 Bot onboarding 默认收敛为 `WebSocket` 模式，直接引导填写 `bot.ws.botId` 与 `bot.ws.secret`，新用户无需域名即可接入。
- 【主动消息】📣 在引导文案中明确 Bot WS 支持主动发消息，适合定时任务、异常提醒、工作流通知等企业场景。
- 【中文体验】🈶 企业微信插件自管账号创建与私聊策略配置流程，减少重复英文提示与术语负担。
- 【流式修复】🌊 修复 Bot WS 仅输出最终结果的问题，恢复块级流式交付能力。
- 【路由稳定】🧭 统一 HTTP 分发链路，并补齐默认账号的显式 Bot/Agent 回调路径别名，降低回调命中偏差。
- 【排障增强】🔎 增加 Agent callback 原始请求、解密摘要、发送请求与响应日志，便于定位“能接收但不能回复”的问题。
- 【配置清理】🧹 移除 `bot.enabled` / `agent.enabled` 冗余字段，README 与配置模型保持一致。

## 验证结果
- `bunx vitest run extensions/wecom/src/onboarding.test.ts extensions/wecom/src/channel.meta.test.ts`
- `pnpm build`

## 升级提示
- 默认推荐继续使用 `Bot WebSocket` 模式；如需公网回调，可手动补充 `bot.webhook`。
- 推荐回调路径使用 `/plugins/wecom/bot/{accountId}` 与 `/plugins/wecom/agent/{accountId}`。
- `package.json` 与插件元数据已同步更新为 `WeCom (企业微信)`，便于在 OpenClaw 渠道列表中直接识别。
