核心用法
@huo15/wecom 是 OpenClaw 的企业微信通道插件,提供三条消息通道:Bot WebSocket(默认推荐,免公网配置)、Agent 自建应用(主动推送)、微信客服(外部客户接入)。支持加密媒体解密、Markdown V2 富文本、图片自动上传、多账号切换、流式回复等能力。配置简单,最小仅需 botId + secret 即可启动。
显著优点
1. 三通道灵活组合:可按场景选择 WS/Agent/客服,多账号独立配置
2. 响应速度快:Bot WebSocket 直连,无需回调部署
3. 媒体处理完善:AES-256-CBC 解密、自动 uploadMedia、COS/OSS 降级占位
4. 安全加固:拒绝 @all 广播、upstream-delivery 隔离、Secret 独立配置
5. 故障自愈:ack timeout watchdog + 自动重连 + Agent API 降级兜底
潜在局限
- 企业微信限定:不支持个人微信协议,需企业资质
- 文件大小限制:超大文件需走 enhance_share_file 链接而非直发
- 流式更新上限:最多 8 次中间更新,长文本场景可能感知明显
- 生态依赖:绑定 OpenClaw 生态,非通用企微 SDK
适合人群
- 企业 IT/运维:快速搭建内部 AI 机器人
- 客服团队:微信客服 + 智能体自动应答
- 多租户 SaaS:单实例托管多企业账号
常规风险
- 密钥泄露:
botId/secret/corpSecret需妥善保管 - 权限过度:Agent API 可主动发消息,需配合 sanitizer 使用
- 版本漂移:持续迭代中(v2.8.x),升级需关注 changelog