OpenClaw 企业微信（WeCom）Channel Plugin，将企业微信接入 OpenClaw AI 助手平台。
参考 sunnoy/openclaw-plugin-wecom，兼容 OpenClaw 2026.2+。
企业微信用户 │ │ 消息回调 (XML + AES-256-CBC) ▼ ┌──────────────────────────────────────┐ │ OpenClaw Gateway │ │ │ │ GET /webhooks/wecom → URL 验证 │ │ POST /webhooks/wecom → 消息回调 │ │ │ │ │ ▼ │ │ ┌──────────────┐ │ │ │ WeCom Plugin │ │ │ │ • 签名校验 │ │ │ │ • AES 解密 │ │ │ │ • 消息标准化 │ │ │ │ • 去重处理 │ │ │ └──────┬───────┘ │ │ │ │ │ ▼ │ │ ┌──────────────┐ │ │ │ OpenClaw │ │ │ │ Agent 处理 │ │ │ └──────┬───────┘ │ │ │ │ │ ▼ │ │ ┌──────────────┐ │ │ │ outbound.send│ │ │ │ → 企微 API │ │ │ │ (文本/MD/图文)│ │ │ └──────────────┘ │ └──────────────────────────────────────┘ 核心原则：插件只负责 Channel Adapter（消息协议适配），不负责 AI 业务逻辑。
@garrent/openclaw-plugin-wecom/ ├── package.json # 含 openclaw.extensions 声明 ├── openclaw.plugin.json # 插件清单（configSchema） ├── tsconfig.json ├── .env.example # 配置参考 └── src/ ├── index.ts # 入口：导出 register + dock ├── channel.ts # ChannelDock + createWecomPlugin ├── normalize.ts # 消息标准化（企微 ↔ OpenClaw） ├── types/ │ └── index.ts # 完整类型定义 ├── utils/ │ ├── crypto.ts # AES-256-CBC + SHA1 签名 │ ├── xml.ts # XML 解析/构建 │ └── logger.ts # 日志工具 └── services/ ├── tokenService.ts # Token 管理（内存缓存+重试） └── wecomApi.ts # 企微 API 封装 openclaw plugins install @garrent/openclaw-plugin-wecomgit clone https://github.com/garrent/openclaw-plugin-wecom.git cd openclaw-plugin-wecom npm install npm run build openclaw plugins install -l ./- 登录 企业微信管理后台
- 我的企业 → 记录
CorpID - 应用管理 → 创建自建应用 → 记录
AgentId和Secret - 应用详情 → 接收消息 → 设置 API 接收：
- URL:
http(s)://你的域名:18789/webhooks/wecom - Token: 随机字符串（记录下来）
- EncodingAESKey: 随机生成（记录下来）
- URL:
编辑 ~/.openclaw/openclaw.json：
{ "plugins": { "entries": { "garrent-wecom": { "enabled": true } } }, "channels": { "garrent-wecom": { "enabled": true, "corpId": "你的企业ID", "agentId": "应用AgentId", "secret": "应用Secret", "token": "回调Token", "encodingAESKey": "回调EncodingAESKey" } } }确保 Gateway 绑定到局域网（而非 loopback），以便企微服务器可以回调：
openclaw config set gateway.bind lanopenclaw gateway restart openclaw channels status1. 用户在企微发送消息 2. 企微服务器 POST → /webhooks/wecom 3. Plugin: SHA1 签名校验 → AES-256-CBC 解密 → XML 解析 4. Plugin: 消息去重（MsgId） 5. Plugin: 立即返回 "success"（解决 5 秒超时） 6. Plugin: 异步调用 api.messaging.receive(normalizedMessage) 7. OpenClaw Agent 处理 → 生成回复 8. OpenClaw 调用 outbound.send(outgoingMessage) 9. Plugin: 转换格式 → 调用企微 API 主动推送回复 企微要求 5 秒内响应，否则重试 3 次。本插件：
- 收到消息后 立即返回
"success" - 异步 将消息分发给 OpenClaw Agent
- Agent 回复后通过 主动推送 API 发送
- MsgId 去重 防止重试导致的重复处理
- 内存缓存（适配 OpenClaw 单进程插件模型）
- 提前 5 分钟刷新（留 buffer）
- 并发请求合并（多个消息同时到达时只刷新一次）
- 失败指数退避重试（1s → 2s → 4s，最多 3 次）
- 完整 SHA1 签名校验（每条消息都验证）
- AES-256-CBC 加解密（含 CorpId 校验）
- Token 失效自动重试（errcode 40014/42001）
| 类型 | 入站（接收） | 出站（回复） |
|---|---|---|
| 文本 | ✅ | ✅ |
| Markdown | - | ✅ (自动检测) |
| 图片 | ✅ (转文本描述) | - |
| 语音 | ✅ (转文本描述) | - |
| 视频 | ✅ (转文本描述) | - |
| 位置 | ✅ (转文本描述) | - |
| 链接 | ✅ (转文本描述) | - |
| 图文 | - | ✅ (附件模式) |
| 事件 | ✅ (subscribe等) | - |
# 安装依赖 npm install # 监听编译 npm run dev # 构建 npm run build| 组件 | 选型 | 说明 |
|---|---|---|
| 语言 | TypeScript | 完整类型安全 |
| 加解密 | Node.js crypto | AES-256-CBC + SHA1 |
| HTTP | axios | 企微 API 调用 |
| XML | xml2js | 消息解析 |
| 日志 | winston | 结构化日志 |
| 宿主 | OpenClaw >= 2026.2 | peerDependency |
MIT