Top AI Repos — open-source AI, indexed and scored

Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.

sunnoy/openclaw-plugin-wecom

企业微信 AI 机器人插件 - Enterprise WeChat (WeCom) AI Bot plugin for OpenClaw. 支持流式输出、动态 Agent 管理、群聊集成、指令白名单等功能。

74ISCJavaScript

Star history, last 90 days
Date	Stars
2026-07-31	705
2026-08-04	706
2026-08-06	706

Star history, last 90 days

Date

Stars

2026-07-31

705

2026-08-04

706

2026-08-06

706

# OpenClaw 企业微信（WeCom）增强插件 [![npm](https://img.shields.io/npm/v/@sunnoy/wecom)](https://www.npmjs.com/package/@sunnoy/wecom) [![license](https://img.shields.io/npm/l/@sunnoy/wecom)](LICENSE) `@sunnoy/wecom` 是 [OpenClaw](https://github.com/openclaw/openclaw) 企业微信渠道的**社区增强插件**，基于官方 [`@wecom/wecom-openclaw-plugin`](https://github.com/WecomTeam/wecom-openclaw-plugin) 的 WebSocket 长连接骨架，提供多账号管理、动态 Agent 隔离、Agent API / Webhook 增强出站、企业微信 MCP 文档/智能表格能力、指令白名单、配额感知等企业级特性。底层 SDK：[`@wecom/aibot-node-sdk`](https://github.com/WecomTeam/aibot-node-sdk) — 企业微信智能机器人 Node.js SDK。 > **⚠️ 从 HTTP 回调迁移到长连接：** 2.0 版本完全采用企业微信 [AI 机器人 WebSocket 长连接模式](https://open.work.weixin.qq.com/help2/pc/cat?doc_id=21657)。如果你之前使用 HTTP 回调（Token + EncodingAESKey + 回调 URL），需要在企业微信管理后台将机器人切换到长连接模式，然后删除旧的回调配置。切换后只需 `botId` 和 `secret` 即可接入。 > **2.1 新增：** 在 WS 长连接之外，2.1 版本新增了企业微信**自建应用"接收消息"HTTP 回调**作为可选入站通道。在 `channels.wecom.agent` 下配置 `callback.token`、`callback.encodingAESKey`、`callback.path` 即可同时启用，与 WS 通道并行运行，互不影响。 ## 相比官方插件的增强特性下表列出了本插件相比 [官方 WeCom OpenClaw 插件](https://github.com/WecomTeam/wecom-openclaw-plugin)（[npm](https://www.npmjs.com/package/@wecom/wecom-openclaw-plugin)）额外提供的能力： | 特性 | 官方插件 | 本插件 | | --- | :---: | :---: | | WebSocket 长连接 + 流式回复 | ✅ | ✅ | | 私聊 / 群聊接收 | ✅ | ✅ | | DM 准入策略（pairing / open / allowlist / disabled） | ✅ | ✅ | | 群聊准入策略（open / allowlist / disabled） | ✅ | ✅ | | 按群配置发送者白名单 | ✅ | ✅ | | 思考占位（`<think>` 占位符） | ✅ | ✅ | | CLI 交互式配置向导 | ✅ | ✅ | | **多账号管理**（多 Bot 独立配置、共享字段继承） | ❌ | ✅ | | **动态 Agent 路由**（按用户 / 群自动隔离会话与工作区） | ❌ | ✅ | | **Workspace 模板**（自动为新 Agent 复制 AGENTS.md 等引导文件） | ❌ | ✅ | | **Agent API 增强出站**（自建应用主动发送文本、图片、文件） | ❌ | ✅ | | **部门 / 标签目标发送**（`party:` / `tag:` 寻址） | ❌ | ✅ | | **Webhook Bot 群通知**（命名 webhook 映射，markdown / 图片 / 文件） | ❌ | ✅ | | **指令白名单**（限制普通用户可执行的 slash 命令） | ❌ | ✅ | | **管理员绕过**（命令白名单 + 动态 Agent 路由） | ❌ | ✅ | | **运行时配额感知**（被动回复 24h 窗口 + 主动发送额度追踪与告警） | ❌ | ✅ | | **Pending Reply 重试**（WS 断连后自动通过 Agent API 补发未送达回复） | ❌ | ✅ | | **Reasoning 流式节流**（800ms 节流防止 SDK 队列溢出） | ❌ | ✅ | | **`<think>` 标签规范化**（兼容 `<thinking>` / `<thought>` 等变体） | ❌ | ✅ | | **Reply 媒体指令解析**（自动提取 LLM 输出中的 `MEDIA:` / `FILE:` 路径） | ❌ | ✅ | | **出站代理**（`network.egressProxyUrl`） | ❌ | ✅ | | **自定义 API 基础地址**（`network.apiBaseUrl` / `WECOM_API_BASE_URL`） | ❌ | ✅ | | **Bindings 路由**（固定绑定企业微信账号到指定 Agent） | ❌ | ✅ | | **消息去重**（reqId + msgId 去重，防止重复处理） | ❌ | ✅ | | **入站图文混排**（`mixed` 消息拆解为文本 + 图片） | ❌ | ✅ | | **入站语音转写**（`voice.content` 自动提取） | ❌ | ✅ | | **入站引用消息**（`quote` 上下文透传） | ❌ | ✅ | | **自建应用回调入站**（HTTP 回调作为独立入站通道，与 WS 并行） | ❌ | ✅ | | **Agent API Markdown 回复**（回调入站回复默认 markdown 格式） | ❌ | ✅ | | **入站/出站信息日志**（WS / CB 收发日志，便于追踪消息流） | ❌ | ✅ | | **官方 MCP 2026.4.23 对齐**（doc auth、SmartPage、媒体拦截器） | ✅ | ✅ | | **MCP 多账号 fallback**（默认账号非长连接时自动选择可用 Bot） | ❌ | ✅ | | **MCP doc-only Skills 部署约束**（避免误用 contact/todo/msg 等未开通能力） | ❌ | ✅ | ## 目录 - [相比官方插件的增强特性](#相比官方插件的增强特性) - [前置要求](#前置要求) - [安装](#安装) - [从 HTTP 回调迁移](#从-http-回调迁移) - [运行测试](#运行测试) - [配置](#配置) - [私聊与群聊准入策略](#私聊与群聊准入策略) - [企业微信侧配置](#企业微信侧配置) - [消息能力与投递策略](#消息能力与投递策略) - [企业微信 MCP 文档与智能表格](#企业微信-mcp-文档与智能表格) - [动态 Agent 与路由](#动态-agent-与路由) - [自建应用回调入站](#自建应用回调入站) - [常见问题](#常见问题) - [项目结构](#项目结构) - [自定义 Skills 配合沙箱使用实践](#自定义-skills-配合沙箱使用实践) - [相关链接](#相关链接) - [贡献与协议](#贡献与协议) ## 前置要求 - 已安装 [OpenClaw](https://github.com/openclaw/openclaw) `2026.3.23-2+` - 企业微信管理后台权限，可创建 AI 机器人或自建应用 - **机器人已切换到长连接模式**（参考[官方文档](https://open.work.weixin.qq.com/help2/pc/cat?doc_id=21657)） - 运行 OpenClaw 的机器可以出站访问： - `wss://openws.work.weixin.qq.com` - `https://qyapi.weixin.qq.com`（启用 Agent / Webhook 时） Bot 主链路不需要企业微信反向访问你的 HTTP 回调地址。 ## 安装 ```bash openclaw plugins install @sunnoy/wecom ``` > **3.0 兼容性说明：** 从 `3.0.0` 开始，本插件仅支持 OpenClaw `2026.3.23-2+`。旧版 OpenClaw 请继续使用 `2.x`。 > **3.1 MCP 说明：** `wecom_mcp` 已按官方 `@wecom/[email protected]` 协商版本与 `@wecom/[email protected]` 对齐。企业规模和机器人权限仍由企业微信后端控制；当前大型企业常见只开放 `doc` 类 MCP 能力。 > **从官方插件迁移：** 如果之前使用 `openclaw plugins install @wecom/wecom-openclaw-plugin`，请先卸载官方插件再