概述
@huo15/wecom 是 OpenClaw 生态中专为企业微信（WeCom）设计的通道插件，版本 v2.8.25 继承并持续优化自 yanhaidao/wecom 上游。该插件以Bot WebSocket 模式为默认架构，实现零部署、低延迟的企业微信接入，同时提供 Agent 自建应用和微信客服两条备用通道，形成完整的三通道消息矩阵。
核心用法
插件支持三种互斥或组合的消息通道：
1. Bot WebSocket（推荐）：企业微信"智能机器人"协议，纯 WS 长连接，无需公网回调部署，配置仅需 botId + secret 即可收发消息。
2. Agent 自建应用：调用企微官方 REST API，支持主动推送给指定用户/群聊，需配置 CorpId/AgentId/Secret。
3. 微信客服：接管外部客户在微信/视频号中的客服会话，实现 C 端用户与 B 端系统的无缝对接。
多账号场景下，每个账号独立配置，支持跨企业、跨智能体的并发路由。
显著优点
- 响应速度极快：WS 模式毫秒级双向通信，较传统 HTTP 回调延迟降低 90%+
- 配置极简：Bot 模式无需域名、SSL、服务器，单机即可跑通
- 媒体处理完整：AES-256-CBC 解密直接输出 buffer，支持图片 OCR、语音 ASR、文档解析
- 流式体验优秀：placeholder + 最多 8 次 partial 更新 + ack timeout 自动重连
- 安全加固：
@all/@everyone/*等广播字面量被显式拒绝，防止误触群发 - 失败降级智能：WS 超时自动 fallback 到 Agent API，保障消息可达性
潜在局限
- 企业微信依赖：仅限企业微信生态，不支持个人微信（协议完全不同）
- 文件大小限制：大文件（> 企微上限）需走
enhance_share_file链接模式，非直发 - v2.8.25 版本迭代快：GUIDANCE 优先级决策表较复杂，用户需理解 MEDIA:/LINK: 的翻转逻辑
- 镜像同步延迟：GitHub 镜像为只读，主仓库在 CNB.cool，国内访问需注意源站稳定性
适合人群
- 需要快速对接企业微信 Bot/自建应用的 OpenClaw 用户
- 有微信客服集成需求的 B2C 企业
- 追求低延迟、免运维的消息通道的技术团队
- 多企业、多账号并发的复杂组织架构
常规风险
- WebSocket 稳定性：长连接存在网络闪断风险，虽 watchdog 自动重连但极端场景可能丢消息
- 媒体 URL 过期：COS/OSS 预签名链接失效时降级为占位文本，用户感知为"图片无法显示"
- Secret 泄露风险：
botId/secret、corpSecret等密钥需妥善保管，建议配合 OpenClaw 密钥管理 - 版本兼容性：迭代频繁（v2.8.20→v2.8.25 仅数月），建议锁定版本或关注 changelog