核心用法
@huo15/wecom 是 OpenClaw 的企业微信（WeCom）官方通道插件，提供 Bot WebSocket、Agent 自建应用、微信客服三条独立消息通道，可单独或组合启用。最小配置仅需 botId + secret 即可通过 WebSocket 接收/回复消息，无需部署公网回调 endpoint。支持多账号并行、跨企业路由，满足复杂组织架构需求。
显著优点
- 三通道灵活架构：Bot WS 响应快配置简，Agent API 支持主动推送，微信客服对接外部用户，覆盖全场景
- 媒体处理能力：内置 AES-256-CBC 解密，支持图片/文件/语音双向传输，OCR/ASR 友好
- 流式交互体验：placeholder + 最多 8 次 partial update + ack timeout watchdog，长文本不卡顿
- 安全加固：拒绝
@all等广播字面量，跨企业消息通道隔离，Secret 独立配置 - 故障自愈：WS 超时自动 fallback 到 Agent API，连续失败触发重连，保障消息可达性
潜在局限
- 企业微信专属：不支持个人微信（不同协议），C 端用户覆盖受限
- 文件大小限制：超大文件需走
enhance_share_file链接模式，非直发 - 版本迭代频繁：v2.8.x 系列多次 GUIDANCE/MEDIA 优先级调整，需关注 changelog 避免行为漂移
- 依赖企微生态：CorpId/AgentId 等企业资质门槛，个人开发者难以独立测试
适合人群
- 已开通企业微信的组织，需为内部员工或外部客户提供 AI 客服
- 需要图片/文件双向交互的自动化场景（如票据识别、合同审核）
- 多企业、多账号管理的 SaaS 服务商或系统集成商
- 对消息实时性要求高、希望免运维回调服务的中小团队
常规风险
- 密钥泄露：WS secret / corpSecret 硬编码配置存在泄露风险，建议配合密钥管理服务
- 权限扩散：Agent API 权限较宽，需严格限制
touser/chatid的 sanitizer 规则 - 上游依赖：fork 自 yanhaidao/wecom，上游更新需手动同步，存在维护滞后风险
- 平台政策变更：企业微信 API 规则调整可能导致功能异常（如 MEDIA 直发限制收紧）