核心用法
@huo15/wecom 是 OpenClaw 生态的企业微信（WeCom）官方通道插件，fork 自 yanhaidao/wecom 并持续维护。插件提供三条独立消息通道：
1. Bot WebSocket（默认推荐）：基于企业微信"智能机器人"WS长连接协议，无需公网回调部署，配置极简、响应延迟低
2. Agent 自建应用：调用企业微信官方 API（CorpId/AgentId/Secret），支持主动推送给指定用户或群聊
3. 微信客服：接管外部客户在微信/视频号内发起的客服会话
三条通道可单独或组合启用，多账号场景下每个账号独立配置。关键配置入口为 channels.wecom.accounts.<id>.{bot|agent|kefu}。
显著优点
- 零回调部署：Bot WS 模式免公网 endpoint，降低运维复杂度与安全暴露面
- 端到端媒体处理：内置 AES-256-CBC 解密，图片/文件/语音可直接送入 Agent 做 OCR/ASR/文档解析
- 富文本适配：自动将 Markdown V2 转换为企业微信支持的格式（标题、表格、代码块、引用等）
- 流式交互体验：placeholder + 最多8次中间更新 + ack timeout 自动重连，缓解大模型长回复等待焦虑
- 多账号原生支持：单实例可并发接入多个企业、多个智能体，按 conversation 自动路由
- 安全加固：
touser/chatid经 sanitizer 过滤，拒绝@all/@everyone/* 等广播字面量（v2.8.1 安全修复）
潜在缺点与局限性
- 协议边界明确：不支持个人微信（WeChat），与企业微信为两套独立协议
- 大文件分流逻辑复杂：v2.8.25 引入 GUIDANCE 决策表管理 MEDIA: 直发与 enhance_share_file 链接的优先级翻转，配置理解成本上升
- 上游依赖风险：持续 fork 自 yanhaidao/wecom，仅单向 fetch 不 push，若上游停更需独立维护
- WS 连接稳定性：虽具备 8 次重连 watchdog，但在弱网或企微服务端限流场景下仍可能丢消息，需依赖 Agent API fallback
- COS/OSS 预签名兼容：部分腾讯云/阿里云 bucket 对 Node 默认 UA 敏感，虽已修复（v2.8.8），但自定义存储后端仍需测试验证
适合人群
- 需要为企业微信组织接入 AI 客服/智能助手的开发团队
- 追求低运维、快速上线的中小型企业（优先 Bot WS 模式）
- 有跨企业、多账号管理需求的 SaaS 服务商或 IT 集成商
- 需处理加密媒体文件（图片、语音、文档）的 RAG 或自动化工作流场景
常规风险
- 密钥泄露风险：botSecret、corpSecret 配置于本地或 CI/CD 环境，需配合密钥管理服务（KMS/Vault）使用
- 消息广播误触：虽 sanitizer 拦截常见广播字面量，但 LLM 输出解析仍存在绕过可能，建议生产环境启用二次确认
- API 速率限制：企业微信官方对自建应用有频次配额，高并发场景需评估是否需要多账号分流
- 版本漂移：频繁小版本迭代（v2.8.x 密集发布），建议锁定版本并阅读 changelog 后再升级