Huo15 Wecom Plugin

核心定位

@huo15/wecom 是 OpenClaw 生态中专为企业微信（WeCom）设计的消息通道插件，v2.9.0 版本提供 Bot WebSocket、Agent 自建应用、微信客服三条独立通道，覆盖从内部智能体到外部客户服务的全场景接入需求。

核心用法

• Bot WebSocket 模式（推荐）：配置 botId + secret 即可启用，无需公网回调服务器，响应延迟最低
• Agent 自建应用模式：通过 CorpId/AgentId/Secret 调用官方 API，支持主动向指定用户/群推送消息
• 微信客服模式：接管外部客户在微信/视频号中的客服会话，适合对外服务场景
• 多账号并发：单实例支持多个企业账号独立配置，按会话自动路由

显著优点

• 加密媒体直出：图片/文件/语音经 AES-256-CBC 解密后直接输出 buffer，Agent 可直接进行 OCR/ASR/文档解析
• 富文本原生支持：Markdown V2 自动适配企微格式（标题、表格、代码块、引用等）
• 智能降级策略：WS ack timeout 自动 fallback 到 Agent API，大文件（>企微上限）自动切换分享链接
• 安全加固：内置 resolveWecomTarget sanitizer，拒绝 @all/@everyone 等广播字面量

局限性与风险

• 协议绑定：专为企业微信设计，不支持个人微信（协议完全不同）
• 版本漂移：上游 fork 自 yanhaidao/wecom，需手动跟踪合并安全更新
• 媒体大小限制：企微对单文件有上限，超大文件需走分享链接降级
• WS 稳定性：极端网络环境下可能出现 placeholder timeout，依赖 watchdog 重连机制

适合人群

• 需要为企业微信接入 LLM 智能体的开发团队
• 有微信客服外部用户服务需求的业务方
• 多企业/多账号管理的 SaaS 服务商

安全评估

• 来源可信度：社区维护 fork（T2）
• 安全等级：A（内置 sanitizer、权限隔离、降级可控，但依赖上游未审计代码）