by 运行时依赖
安装命令
点击复制技能文档
火一五企业微信插件
@huo15/wecom 是 OpenClaw 的企业微信通道插件，fork 自 yanhAIdao/wecom 并持续合并上游。默认 机器人 网页Socket 模式，配置简单、响应快；同时支持 代理 自建应用主动推送和微信客服三方通道。
三条消息通道 通道 用途 配置入口 机器人 网页Socket 默认推荐，企业微信"智能机器人"WS 协议，免公网回调 channels.wecom.accounts..机器人.ws 代理 自建应用 走企微官方 API（CorpId/代理Id/Secret），支持主动推送给指定用户/群 channels.wecom.accounts..代理 微信客服 接管"客服会话"，外部客户在微信/视频号里发给客服账号的消息 channels.wecom.accounts..kefu
三条通道可以单独启用或组合启用，多账号场景每个账号独立配置。
安装 # OpenClaw 内置安装（推荐） OpenClaw 插件s 安装 @huo15/wecom
# 或者直接 npm npm 安装 @huo15/wecom
最小配置（机器人 WS 模式） # ~/.OpenClaw/OpenClaw.json 中 channels: wecom: enabled: true accounts: default: 机器人: ws: 机器人Id: "你的智能机器人 ID" secret: "WS 密钥"
启动后，机器人 收到的消息会自动路由到默认 代理，回复也通过 WS 直接送回 — 不需要部署任何回调 端点。
关键能力 加密媒体解密：图片/文件/语音 AES-256-CBC 解密直接拿 buffer，可让 代理 直接读取（OCR / ASR / 文档解析） Markdown V2：支持企微富文本（标题、表格、代码块、链接、引用），自动适配 chat 上下文 图片回复：!alt 自动抽离 + 上传Media + replyMedia，COS/OSS 预签名 URL 失败时降级为占位文本（不让"链接已过期"漏到客户端） 多账号切换：单实例支持多个企业、多个智能体并存，按 conversation 路由 流式回复：placeholder + partial reply流（最多 8 次中间更新）+ ack timeout watchdog 自动重连 v2.8.8 关键修复（WS 机器人 图片） Reply 通道纠错：reply 上下文从 发送MediaMessage（主动推送）改用 replyMedia（被动回复，绑定 reqId） 入向多图：mixed 与 quote.mixed 类型从只取首张改为全部提取；首张挂 ctx.MediaPath，其余落盘 + 信息 日志 Outbound fetch UA：从裸 fetch 切到 插件-sdk fetchRemoteMedia，显式带 桌面 User-代理，避免部分 Tencent COS / 阿里 OSS bucket 拒绝 Node 默认 UA 解析可观测性：媒体类型消息但无 attachments 时记 warn 日志（含 msgid + body keys），便于 SDK 字段漂移排查
详见 change记录/v2.8.8.md。
安全实践 LLM 输出的 touser / chatid 经 resolveWecomTar获取 sanitizer，拒绝 @all / @everyone / * 等广播字面量（v2.8.1 SECURITY 修复） 跨企业上下游消息走 up流-delivery 通道，不与本企业 代理 API 混用 微信客服 corpSecret 可与 代理 corpSecret 独立配置，权限隔离 不变的设计原则 机器人 WS 优先：能用 WS 就不用 代理 API（少配置、低延迟） 失败降级：WS reply ack timeout 自动 fallback 到 代理 API（保留消息可达性），watchdog 连续 8 次后触发 WS 重连 不修改 OpenClaw 核心：所有功能通过 channel 插件 SDK 注册 仓库 主仓库：https://cnb.cool/huo15/AI/huo15-wecom-插件 镜像：https://github.com/zhaobod1/huo15-wecom-插件 上游 fork 源：https://github.com/yanhAIdao/wecom（仅 fetch，不 push） License
ISC（继承自 yanhAIdao/wecom 上游）。