核心用法
@huo15/wecom 是 OpenClaw 的企业微信官方通道插件，提供 Bot WebSocket、Agent 自建应用、微信客服 三条独立消息通道，支持多账号并存与按会话路由。
典型接入场景：
- Bot WS 模式（推荐）：配置
botId+secret即可，免公网回调、响应快，适合快速上线 - Agent 模式：需 CorpId/AgentId/Secret，支持主动推送给指定用户/群聊
- 微信客服模式：接管外部客户在微信/视频号中的客服会话，适合售前售后场景
关键功能亮点：
- 加密媒体自动 AES-256-CBC 解密，Agent 可直接消费图片/文件/语音
- Markdown V2 富文本自动适配企微格式（标题、表格、代码块、链接）
- 图片回复自动化：
→ uploadMedia → replyMedia，COS/OSS 预签名失败时降级占位 - 流式回复支持 placeholder + 最多 8 次 partial update，ack timeout 自动重连
- 多账号切换：单实例承载多个企业、多个智能体
v2.8.25 重要变更：GUIDANCE 优先级翻转回 MEDIA: 直发——此前因 stream 截断风险临时改为链接优先，经 v2.8.23-v2.8.24 群聊推送修复后，默认直发媒体，仅超大文件走 enhance_share_file 链接。
显著优点
1. 配置极简：Bot WS 模式两行配置即可运行，无需域名、SSL、回调 endpoint
2. 官方协议：基于企微 OpenAPI + Bot WS 协议，非破解/Hook 方案，合规风险低
3. 三通道灵活组合：可按场景启用单通道或多通道，客服、Bot、主动推送互不干扰
4. 媒体能力完整：加密文件自动解密、双向文件传输、富文本渲染、图片防过期降级
5. 高可用设计：WS ack timeout 自动 fallback Agent API，watchdog 连续失败触发重连
潜在缺点与局限性
1. 仅限企业微信：明确不支持个人微信（不同协议），C 端用户需引导关注企业号或使用客服
2. Bot WS 被动限制：仅能被动回复，无法主动推送（需切 Agent 通道）
3. 文件大小限制：企微本身有单文件 20MB（Bot）/ 2GB（Agent）限制，超大文件需走外链
4. CorpId/Secret 管理成本：多账号场景需维护多套凭证，权限配置繁琐
5. 上游依赖：fork 自 yanhaidao/wecom，长期维护依赖社区活跃度
适合人群
- 企业 IT/运维团队：快速为内部系统接入企微机器人
- AI 客服产品团队：需要图片/文件双向传输的客服场景
- 多租户 SaaS 开发者：单实例服务多个企业客户
- OpenClaw 生态用户：已有 OpenClaw 基础，需扩展企微通道
常规风险
- 凭证泄露：CorpId/Secret/BotSecret 若硬编码或日志泄露，可导致企业数据泄露
- 权限越界：v2.8.1 已修复
@all广播字面量注入风险，但自定义 target 解析仍需审计 - WS 连接稳定性：企业网络策略可能阻断 WebSocket，需准备 Agent fallback
- 媒体存储成本：自动解密后的文件若未清理，可能累积存储占用
- 合规边界：仅限企业微信协议内使用，禁止用于个人微信自动化（官方打击）。